REST API · V2.2

INTEGRASI API
4 SERVER.

Integrasikan nomor virtual di Server 1–4, OTP, dan deposit.
Satu API. Banyak kemungkinan.

JSON Format responsx-apikey Autentikasi120/menit Per akun

BUKU PANDUAN01 / Mulai di sini 02 / API Explorer 03 / Status & error

Base URL otomatis

http://averotp.web.id/apiAlamat API mengikuti domain website yang sedang dibuka. Tidak perlu mengisi domain di .env atau pengaturan API.

Butuh API key?

Buka pengaturan akun ↗

CHAPTER 01

Dari nol ke request pertama.

Siapkan akun
Daftar, verifikasi email, lalu buat API key dari menu Profil → API Key. Key tersimpan dan bisa dilihat serta disalin kembali dari Profil.
Kirim header
Gunakan x-apikey: YOUR_API_KEY. Simpan key di server integrasi, bukan kode frontend publik.
Ikuti alur order
Server 1–4 → Services → Countries → Operators → Buat order → Cek OTP. Hanya server dengan saldo lebih dari 0 yang bertanda online. Katalog dan ID berlaku hanya untuk server yang dipilih.

Mulai dari Status API tanpa key. Uji saldo setelah key tersedia. Isi saldo sebelum membuat order.

CHAPTER 02

API Explorer13

TRY IT!

Pilih endpoint, isi parameter, lalu kirim request ke website ini. URL pada contoh cURL, JavaScript, dan Python memakai domain website ini secara otomatis.

Cari endpoint

13 endpoint tersedia

API key untuk pengujian

Key hanya berada di memori halaman dan tidak disimpan ke browser.

GETStatus API/api/health+

Periksa apakah aplikasi merespons. Tidak menguji koneksi provider atau database.

Tanpa autentikasi · Umum

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "status": "online",
  "timestamp": "2026-10-03T10:00:00.000Z"
}

Respons aktual

GETSaldo akun/api/v1/user/balance+

Lihat saldo, total order, dan total deposit akun.

Header x-apikey wajib · Akun

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "username": "demo",
    "email": "[email protected]",
    "balance": 25000,
    "balance_formatted": "Rp25.000",
    "total_orders": 3,
    "total_deposit": 50000
  }
}

Respons aktual

GETDaftar server/api/v2/servers+

Empat server: Server 1, 2, 3, dan 4. Field active hanya true bila server aktif, API key valid, dan saldo provider lebih dari nol. Nama provider dan kredensial tidak dibuka di API publik.

Header x-apikey wajib · Nomor & OTP

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Server 1",
      "code": "server-1",
      "active": true,
      "balance": 50000
    },
    {
      "id": 2,
      "name": "Server 2",
      "code": "server-2",
      "active": false,
      "balance": 0
    },
    {
      "id": 3,
      "name": "Server 3",
      "code": "server-3",
      "active": false,
      "balance": null
    },
    {
      "id": 4,
      "name": "Server 4",
      "code": "server-4",
      "active": true,
      "balance": 100000
    }
  ]
}

Respons aktual

GETDaftar layanan/api/v2/services+

Gunakan server_id 1–4 dari /api/v2/servers; kode layanan tidak selalu angka, ikuti ID dari respons setiap server.

Header x-apikey wajib · Nomor & OTP

Query parameters

server_id OpsionalID server dari daftar server. Default: 1.

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "server_id": 1,
  "data": []
}

Respons aktual

GETNegara & harga/api/v2/countries+

Daftar negara serta harga dan stok spesifik Server 1–4. Gunakan string number_id dan provider_id persis seperti yang dikembalikan server pilihan, jangan mencampur ID antar-server.

Header x-apikey wajib · Nomor & OTP

Query parameters

server_id OpsionalID server. Default: 1.service_id WajibID layanan dari respons services.

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "server_id": 1,
  "service_id": "ID_LAYANAN",
  "data": []
}

Respons aktual

GETDaftar operator/api/v2/operators+

Ambil operator untuk negara dan layanan terpilih. Daftar kosong berarti hanya operator default (any) yang tersedia.

Header x-apikey wajib · Nomor & OTP

Query parameters

server_id OpsionalID server. Default: 1.country Wajibnumber_id negara dari respons countries.service_id WajibID layanan dari respons services.

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "server_id": 1,
  "data": []
}

Respons aktual

POSTBuat order/api/v2/orders+

Membeli nomor dan memotong saldo sesuai harga final. Pastikan ID berasal dari server dan layanan yang sama.

Header x-apikey wajib · Nomor & OTP

Body JSON

server_id WajibID server yang dipilih.service_id WajibID layanan.number_id Wajibnumber_id dari countries.provider_id Wajibprovider_id dari pricelist.operator_id OpsionalID operator dari operators. Kosong, 0, atau any = operator apa saja.

Memuat contoh kode…

Request ini membeli nomor dan memotong saldo akun. Saya setuju menjalankan tindakan ini.

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "order_id": "KNO_CONTOH",
    "server_id": 1,
    "service": "Contoh layanan",
    "country": "Indonesia",
    "operator": "Contoh operator",
    "phone_number": "62xxxxxxxxxx",
    "price": 5000,
    "price_formatted": "Rp5.000",
    "status": "pending",
    "expired_at": "2026-10-03T10:20:00.000Z",
    "balance": 20000,
    "balance_formatted": "Rp20.000"
  }
}

Respons aktual

GETCek status & OTP/api/v1/orders/get_status+

Memperbarui status order dari provider; refund dapat diproses jika order dibatalkan. Gunakan order_id lokal dari respons buat order.

Header x-apikey wajib · Nomor & OTP

Query parameters

order_id WajibID order milik akun.

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "order_id": "KNO_CONTOH",
    "server_id": 1,
    "status": "received",
    "phone_number": "62xxxxxxxxxx",
    "otp_code": "123456",
    "otp_message": "Contoh pesan OTP",
    "price": 5000,
    "refunded": false,
    "balance": 20000,
    "created_at": "2026-10-03T10:00:00.000Z",
    "expired_at": "2026-10-03T10:20:00.000Z"
  }
}

Respons aktual

POSTBatalkan order/api/v1/orders/set_status+

Hanya order pending atau expiring yang dapat dibatalkan, mengikuti persetujuan provider.

Header x-apikey wajib · Nomor & OTP

Body JSON

order_id WajibID order milik akun.status WajibHanya cancel yang didukung.

Memuat contoh kode…

Request ini membatalkan order yang dipilih dan memproses refund jika berhasil. Saya setuju menjalankan tindakan ini.

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "order_id": "KNO_CONTOH",
    "status": "canceled",
    "refunded": true,
    "refund_amount": 5000,
    "balance": 25000
  }
}

Respons aktual

GETMetode deposit/api/v2/deposit/servers+

Lihat status gateway, batas nominal dan biaya admin. active harus true sebelum membuat invoice.

Header x-apikey wajib · Deposit

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": [
    {
      "id": "averpay",
      "name": "Averpay QRIS",
      "method": "qris",
      "active": true,
      "minimum": 2000,
      "maximum": 5000000,
      "fee": 0
    }
  ]
}

Respons aktual

POSTBuat invoice QRIS/api/v2/deposit/create+

Buat invoice untuk menambah saldo Rp2.000–Rp5.000.000. Biaya admin/provider ditambahkan ke total pembayaran. Satu invoice aktif per akun.

Header x-apikey wajib · Deposit

Body JSON

deposit_server_id OpsionalGateway yang didukung: averpay.amount WajibSaldo yang ingin diterima, dalam rupiah.

Memuat contoh kode…

Request ini membuat invoice pembayaran QRIS baru. Saya setuju menjalankan tindakan ini.

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "deposit_id": "DEP_CONTOH",
    "deposit_server_id": "averpay",
    "method": "qris",
    "amount_received": 10000,
    "admin_fee": 0,
    "provider_fee": 0,
    "total_payment": 10000,
    "qr_string": "CONTOH_QRIS",
    "qr_image": "",
    "status": "pending",
    "expired_at": "2026-10-03T10:20:00.000Z"
  }
}

Respons aktual

GETCek deposit/api/v2/deposit/get_status+

Periksa pembayaran dan perbarui saldo jika pembayaran telah berhasil.

Header x-apikey wajib · Deposit

Query parameters

deposit_id WajibID invoice milik akun.

Memuat contoh kode…

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "deposit_id": "DEP_CONTOH",
    "status": "success",
    "amount_received": 10000,
    "total_payment": 10000,
    "paid_at": "2026-10-03T10:05:00.000Z",
    "expired_at": "2026-10-03T10:20:00.000Z",
    "balance": 35000
  }
}

Respons aktual

POSTBatalkan invoice/api/v1/deposit/cancel+

Batalkan invoice pending melalui gateway pembayaran.

Header x-apikey wajib · Deposit

Body JSON

deposit_id WajibID invoice milik akun.

Memuat contoh kode…

Request ini membatalkan invoice deposit yang dipilih. Saya setuju menjalankan tindakan ini.

Lihat contoh respons JSON

Ilustrasi format, bukan data live. Array katalog dapat kosong; isi dan field provider mengikuti server aktif.

{
  "success": true,
  "data": {
    "deposit_id": "DEP_CONTOH",
    "status": "cancel"
  }
}

Respons aktual

CHAPTER 03

Baca responsnya.

Respons berhasil memakai success: true. Jika gagal, baca error.code dan error.message.

HTTP	Arti & tindakan
401	Key kosong, salah, atau telah dicabut.
403	Akun nonaktif atau email belum diverifikasi.
402	Saldo tidak cukup. Isi saldo terlebih dahulu.
404	Order, invoice, server, atau endpoint tidak ditemukan.
409	Stok habis, invoice aktif, atau status tidak dapat diubah.
422	Parameter wajib belum lengkap atau nilainya tidak valid.
429	Batas request tercapai. Tunggu hingga jendela satu menit berakhir.
500	Kesalahan internal aplikasi.
502	Provider gagal memproses request.

Status order

pending → received → completed. Status lain: expiring, canceled. Deposit memakai pending, success, cancel.

Jangan ulangi POST secara otomatis setelah timeout. Periksa Aktivitas atau Deposit dahulu agar tidak membuat transaksi ganda. GET alias transaksi lama tetap didukung backend; gunakan POST untuk integrasi baru.

INTEGRASI API4 SERVER.

Dari nol ke request pertama.

API Explorer13

Query parameters

Query parameters

Query parameters

Body JSON

Query parameters

Body JSON

Body JSON

Query parameters

Body JSON

Baca responsnya.

Status order

INTEGRASI API
4 SERVER.