Memvalidasi rekening bank tujuan sebelum transfer. Tidak memotong saldo deposit.
URL: POST /api/v1/merchant/disbursement/inquiry
| Header | Wajib | Keterangan |
|---|
X-API-Key | Ya | API Key merchant |
Content-Type | Ya | application/json |
X-Signature | Kondisional | Jika Signature Validation aktif |
X-Timestamp | Kondisional | Unix timestamp (jika Signature Validation aktif) |
| Field | Tipe | Wajib | Keterangan |
|---|
product_id | String | Ya | Kode produk transfer (contoh: "DSTF") |
account_number | String | Ya | Nomor rekening tujuan |
amount | String | Ya | Nominal transfer dalam IDR (digits only, min "10000") |
bank_code | String | Tidak | Kode bank tujuan — disarankan untuk akurasi routing |
{
"product_id": "DSTF",
"account_number": "1380610457",
"amount": "100000",
"bank_code": "014"
}
curl --location 'https://api-sandbox.alfakios.com/api/v1/merchant/disbursement/inquiry' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: apk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--data '{
"product_id": "DSTF",
"account_number": "1380610457",
"amount": "100000",
"bank_code": "014"
}'
| Field | Tipe | Keterangan |
|---|
trx_id | String | ID transaksi internal sistem |
req_id | String | req_id yang dikirim merchant |
ref_id | String | ID referensi transaksi (sama dengan trx_id) |
inquiry_reff | String | Referensi inquiry dari biller — digunakan internal pada step payment |
account_name | String | Nama pemilik rekening tujuan |
account_number | String | Nomor rekening tujuan |
bank_code | String | Kode bank tujuan |
bank_name | String | Nama bank tujuan |
amount | String | Nominal transfer |
fee | String | Biaya admin transfer |
total_cost | String | Total biaya (amount + fee) |
balance | String | Saldo deposit merchant saat ini |
status | String | Status inquiry: SUCCESS atau FAILED |
rc | String | Kode respon dari biller |
description | String | Keterangan RC |
message | String | Keterangan detail |
data | Object | Informasi tambahan dari biller |
details | String | String OtomaX-style — lihat Integrasi OtomaX |
{
"success": true,
"message": "Disbursement inquiry completed",
"rc": "000",
"data": {
"trx_id": "1777946295495371000",
"req_id": "PAY-20240430-001",
"ref_id": "1777946295495371000",
"inquiry_reff": "1017797",
"account_name": "DUMMY NAME",
"account_number": "1380610457",
"bank_code": "014",
"bank_name": "Bank Central Asia",
"amount": "100000",
"fee": "3000",
"total_cost": "103000",
"balance": "281994",
"status": "SUCCESS",
"rc": "00",
"description": "Transaksi Sukses",
"message": "INQUIRY DISBURSEMENT DSTF KE 1380610457 SUKSES",
"data": {},
"details": "REQID:PAY-20240430-001.REFID:1777946295495371000.INQREF:1017797.STATUS:SUCCESS.RC:00.NAMA:DUMMY NAME.REK:1380610457.KODEBANK:014.NOMINAL:100000.FEE:3000.TOTAL:103000.SALDO:281994.KET:Transaksi Sukses"
}
}
{
"success": true,
"message": "Disbursement inquiry completed",
"rc": "051",
"data": {
"req_id": "",
"ref_id": "REF-1714435200200002",
"inquiry_reff": "",
"account_name": "",
"account_number": "9999999999",
"bank_code": "014",
"bank_name": "Bank Central Asia",
"amount": "500000",
"fee": "0",
"total_cost": "0",
"balance": "5000000",
"status": "FAILED",
"rc": "051",
"description": "Account Not Found",
"message": "Rekening tidak ditemukan atau tidak aktif",
"data": {}
}
}
{
"success": false,
"message": "Validation failed",
"errors": [
{
"field": "amount",
"message": "amount must be a positive integer (digits only)"
}
]
}
inquiry_reff digunakan secara internal oleh sistem — Anda tidak perlu meneruskan nilai ini ke endpoint payment.- Catat
fee dan total_cost dari response inquiry untuk ditampilkan kepada pengguna sebelum konfirmasi transfer.
- Rekening yang tidak ditemukan (
rc: "051") tidak memotong saldo; aman untuk dicoba ulang dengan nomor yang berbeda.