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

Referensi Kode Bank

Lihat daftar lengkap kode bank/e-wallet di halaman Bank List.

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",
    "amount": 10000,
    "fee": {
      "amount": 1500,
      "percentage": 0,
      "fixed": 1500
    },
    "totalAmount": 11500,
    "status": "pending"
  }
}

Field Response

Field	Keterangan
merchantTrxId	ID transaksi merchant
platformTrxId	ID transaksi platform KingsPay
amount	Jumlah yang ditransfer
fee.amount	Nominal fee disbursement yang ditagih ke merchant
fee.percentage	Selalu 0 — fee disbursement bersifat tetap per transaksi
fee.fixed	Komponen fee tetap merchant
totalAmount	Total yang didebit dari saldo merchant (amount + fee.amount)
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.