Cek Status Disbursement

Mengecek status terbaru dari transaksi disbursement yang sebelumnya dikirim. Gunakan endpoint ini ketika transaksi mengembalikan status: "PENDING".

URL: POST /api/v1/merchant/disbursement/status

Request

Headers

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)

Body

Field	Tipe	Wajib	Keterangan
`product_id`	String	Ya	Kode produk yang digunakan saat transaksi
`account_number`	String	Ya	Nomor rekening tujuan
`amount`	String	Ya	Nominal yang ditransfer
`req_id`	String	Ya	`req_id` dari response payment yang ingin dicek
`bank_code`	String	Tidak	Kode bank tujuan (opsional)

Contoh Request

{
  "product_id": "DSTF",
  "account_number": "1380610457",
  "amount": "100000",
  "bank_code": "014",
  "req_id": "PAY-20240430-001"
}

curl --location 'https://api-sandbox.alfakios.com/api/v1/merchant/disbursement/status' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: apk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --data '{
    "product_id": "DSTF",
    "account_number": "1380610457",
    "amount": "100000",
    "bank_code": "014",
    "req_id": "PAY-20240430-001"
  }'

Response

Response menggunakan shape yang identik dengan response Inquiry Rekening, termasuk field details berformat OtomaX.

Spesifikasi

Field	Tipe	Keterangan
`trx_id`	String	ID transaksi internal sistem
`req_id`	String	`req_id` yang dicek
`ref_id`	String	ID referensi dari biller
`inquiry_reff`	String	Referensi inquiry dari biller
`account_name`	String	Nama pemilik rekening
`account_number`	String	Nomor rekening tujuan
`bank_code`	String	Kode bank
`bank_name`	String	Nama bank
`amount`	String	Nominal transfer
`fee`	String	Biaya admin
`total_cost`	String	Total biaya
`balance`	String	Saldo merchant (bisa kosong — gunakan `/balance/merchant` untuk saldo terbaru)
`status`	String	Status final: `SUCCESS`, `FAILED`, atau `PENDING`
`rc`	String	Kode respon
`description`	String	Keterangan RC
`message`	String	Keterangan detail
`data`	Object	Informasi tambahan
`details`	String	String OtomaX-style

Contoh Response — Konfirmasi Sukses

{
  "success": true,
  "message": "Disbursement direct transfer completed",
  "rc": "000",
  "data": {
    "trx_id": "177794638960894000",
    "req_id": "PAY-20240430-001",
    "ref_id": "980173",
    "inquiry_reff": "976373",
    "account_name": "DUMMY NAME",
    "account_number": "1380610457",
    "bank_code": "014",
    "bank_name": "",
    "amount": "10000",
    "fee": "3000",
    "total_cost": "13000",
    "balance": "",
    "status": "SUCCESS",
    "rc": "000",
    "description": "Transaksi Sukses",
    "message": "STATUS DISBURSEMENT DSTF KE 1380610457: SUCCESS",
    "data": {},
    "details": "REQID:PAY-20240430-001.REFID:980173.INQREF:976373.STATUS:SUCCESS.RC:000.NAMA:DUMMY NAME.REK:1380610457.KODEBANK:014.NOMINAL:10000.FEE:3000.TOTAL:13000.KET:Transaksi Sukses"
  }
}

Contoh Response — Masih PENDING

{
  "success": true,
  "message": "Disbursement direct transfer completed",
  "rc": "021",
  "data": {
    "req_id": "PAY-20240430-003",
    "ref_id": "980174",
    "account_number": "1380610457",
    "account_name": "BUDI SANTOSO",
    "status": "PENDING",
    "rc": "021",
    "description": "Transaction Pending",
    "message": "STATUS DISBURSEMENT DSTF KE 1380610457: PENDING",
    "data": {}
  }
}

Catatan

Field balance pada response /status bisa kosong. Gunakan endpoint Cek Saldo untuk mendapatkan saldo merchant terbaru.
Jika setelah 5 kali polling status masih PENDING, eskalasi ke tim support dengan menyertakan req_id.

Keyboard shortcuts

Relay Merchant API