Account Inquiry

Memvalidasi nomor rekening bank sebelum melakukan transfer. Wajib dipanggil sebelum endpoint transfer untuk memastikan data rekening benar.

Endpoint

POST /api/v1/disbursement/account-inquiry

Request Body

Parameter	Tipe	Wajib	Keterangan
merchantTrxId	string	Ya	ID transaksi unik dari merchant
accountNo	string	Ya	Nomor rekening tujuan
bankCode	string	Ya	Kode bank (contoh: BNI, BCA, BRI)
amount	number	Ya	Jumlah transfer (dalam Rupiah)

Contoh Request

{
  "merchantTrxId": "{{requestId}}",
  "accountNo": "123456789",
  "bankCode": "BNI",
  "amount": 10000
}

Response Sukses

{
  "logId": "ldTAIkiZwBDblWyCN8OE",
  "status": true,
  "message": "Inquiry success",
  "data": {
    "merchantTrxId": "2026012504373574936905643",
    "platformTrxId": "2026012421374086207",
    "accountNo": "123456789",
    "accountName": "Brianne Hyatt",
    "bankCode": "BNI",
    "amount": 10000
  }
}

Field Response

Field	Keterangan
merchantTrxId	ID transaksi merchant
platformTrxId	ID transaksi platform KingsPay
accountNo	Nomor rekening
accountName	Nama pemilik rekening (harus cocok saat transfer)
bankCode	Kode bank
amount	Jumlah yang akan ditransfer

Alur Disbursement

1. Panggil Account Inquiry untuk validasi rekening dan dapatkan accountName serta platformTrxId
2. Gunakan data tersebut untuk memanggil Transfer dengan accountName dan platformTrxId yang sama