Lewati ke isi

Pengenalan & persiapan integrasi

Pengenalan

Digiprosb menyediakan API reseller untuk transaksi prabayar via koneksi host-to-host.

Base URL

https://api.digiprosb.id/reseller/api/v1

Autentikasi

  • Header : Authorization: Bearer <JWT>
    Token diperoleh dari halaman Settings (portal reseller).

Field Transaksi

Berikut adalah field yang wajib disertakan saat melakukan transaksi:

  • code: kode produk (SKU)
  • msisdn: nomor tujuan / ID tujuan sesuai produk
  • request_id: ID unik dari sisi client

Persiapan integrasi

Checklist sebelum mulai hit API production.

1. IP statis & whitelist

  • Pastikan server integrasi memakai IP statis (atau rentang yang disepakati).
  • Kirim IP ke tim Digiprosb untuk whitelist di sisi API.
  • Tanpa whitelist, request dapat ditolak di layer jaringan atau aplikasi.

2. Token (JWT)

  1. Login ke portal reseller Digiprosb.
  2. Buka Settings.
  3. Salin token dan simpan sebagai rahasia .
  4. Header: Authorization: Bearer <token>.

3. Konvensi request_id

  • Harus unik per percobaan transaksi baru dari sisi Anda.
  • Jika Anda mengirim ulang request_id yang sudah pernah diproses di server Digiprosb, API mengembalikan respons yang sama dengan transaksi tersebut (idempotensi).

4. HTTPS

Selalu gunakan HTTPS untuk semua panggilan API.

Alur transaksi

Direct purchase tanpa inquiry

Dipakai saat produk tidak butuh pre-check.

  1. (Opsional) GET /saldo
  2. POST /purchase
  3. Server Digiprosb merespons pending (rc=68) pada request pertama
  4. Setelah merespons pending, Digiprosb meneruskan request ke biller/provider
  5. Saat biller mengembalikan hasil final, Digiprosb mengirim hasil final ke Client/Reseller dalam bentuk callback
sequenceDiagram
  autonumber
  participant Client as Client/Reseller
  participant Digiprosb as Digiprosb
  participant Biller as Biller/Provider

  Client->>Digiprosb: POST /purchase (code, msisdn, request_id)
  Digiprosb-->>Client: pending (rc=68)
  Digiprosb->>Biller: request transaksi
  Biller-->>Digiprosb: hasil final
  Digiprosb-->>Client: callback final (rc=00 / gagal)

Payment dengan inquiry

Dipakai saat produk butuh validasi dulu (contoh: PLN, DANA — lalu POST /payment).

  1. POST /inquiry
  2. Validasi hasil inquiry (rc=00, data pelanggan/produk)
  3. POST /purchase
  4. Jika rc=68, lanjut POST /status
sequenceDiagram
  autonumber
  participant Client as Client/Reseller
  participant Digiprosb as Digiprosb
  participant Biller as Biller/Provider

  Client->>Digiprosb: POST /inquiry
  Digiprosb-->>Client: response inquiry
  Client->>Digiprosb: POST /payment
  Digiprosb->>Biller: request transaksi
  Biller-->>Digiprosb: hasil final
  Digiprosb-->>Client: final (rc=00 / gagal)

Referensi cepat