Dokumentasi API

Integrasikan layanan PPOB ke sistem Anda dengan mudah melalui API Ezidcode.

Informasi Dasar

Base URL

https://dashboard.ezidcode.com/api

Method

POST

Keamanan

Wajib mendaftarkan IP Server Anda di menu Whitelist pada Dashboard akun Ezidcode.

1. Cek Saldo (Balance)

Mengecek sisa saldo Anda di sistem.

{
  "username": "YOUR_USERNAME",
  "api_key": "YOUR_API_KEY",
  "cmd": "balance"
}

2. Ambil Daftar Harga (Pricelist)

Mengambil data produk dan harga yang sudah ditambah markup global admin.

{
  "username": "YOUR_USERNAME",
  "api_key": "YOUR_API_KEY",
  "cmd": "pricelist"
}

3. Transaksi (Topup)

Melakukan pembelian produk ke provider melalui.

{
  "username": "YOUR_USERNAME",
  "api_key": "YOUR_API_KEY",
  "cmd": "topup",
  "sku": "ax10",
  "target": "08123456789",
  "ref_id": "YOUR_REF_ID",
  "price_bridge": 10930
}

* Nilai price adalah harga modal dari pricelist ditambah markup internal sistem Anda.

4. Cek Status Transaksi

Mengecek status terkini dari sebuah transaksi.

{
  "username": "YOUR_USERNAME",
  "api_key": "YOUR_API_KEY",
  "cmd": "check_status",
  "sku": "ax10",
  "target": "08123456789",
  "ref_id": "YOUR_REF_ID"
}

5. Webhook (Callback Status)

Sistem Ezidcode akan mengirimkan notifikasi perubahan status transaksi secara otomatis ke URL Webhook/Callback Anda secara real-time tanpa perlu melakukan Cek Status berulang-ulang.

Pengaturan URL

Daftarkan URL Webhook Server Anda pada menu Webhook di Dashboard User (https://dashboard.ezidcode.com/webhook)

Method

POST

Contoh Payload (JSON) yang akan diterima oleh Server Anda:

{
  "ref_id": "YOUR_REF_ID",
  "target": "08123456789",
  "sku": "ax10",
  "status": "Sukses",
  "sn": "20190401214753214742",
  "message": "Transaksi Sukses"
}

* Pastikan script Webhook/Callback di server Anda mengembalikan HTTP status 200 OK setelah berhasil menerima data.