Transfer

Melakukan transfer dana ke rekening bank tujuan. Pastikan telah memanggil Account Inquiry terlebih dahulu untuk validasi rekening.

Endpoint

POST /api/v1/disbursement/transfer

Request Body

Parameter	Tipe	Wajib	Keterangan
accountNo	string	Ya	Nomor rekening tujuan
accountName	string	Ya	Nama pemilik rekening (harus match dengan inquiry)
bankCode	string	Ya	Kode bank (contoh: BCA, BNI, BRI)
amount	number	Ya	Jumlah transfer (dalam Rupiah)
merchantTrxId	string	Ya	ID transaksi unik dari merchant
platformTrxId	string	Ya	platformTrxId dari hasil Account Inquiry
notifyUrl	string	Ya	URL webhook untuk menerima notifikasi status transfer

Contoh Request

{
  "accountNo": "3831358597",
  "accountName": "LOUIS WILLIAM TANOTO",
  "bankCode": "BCA",
  "amount": 10000,
  "merchantTrxId": "{{requestId}}",
  "platformTrxId": "2026022109022897500",
  "notifyUrl": "https://webhook.site/8043de7b-12ec-44b2-a411-26f67b6b5fd5"
}

Response Sukses

{
  "logId": "FzWm3qcyTnEV7xiRHQhm",
  "status": true,
  "message": "Request diterima, akan segera diproses",
  "data": {
    "merchantTrxId": "2026012706571124684829011",
    "platformTrxId": "2026012623571680343",
    "status": "pending"
  }
}

Field Response

Field	Keterangan
merchantTrxId	ID transaksi merchant
platformTrxId	ID transaksi platform KingsPay
status	Status awal (biasanya pending). Status akhir dikirim via webhook ke notifyUrl

Webhook

Status final transfer (success/failed) akan dikirim ke notifyUrl yang Anda berikan. Pastikan endpoint webhook Anda dapat menerima dan memproses notifikasi.