Transfer

向目标银行账户发起转账。请先调用 Account Inquiry 完成账户校验。

Endpoint

POST /api/v1/disbursement/transfer

Request Body

Parameter	Type	Required	Description
accountNo	string	Yes	收款账号
accountName	string	Yes	账户姓名（需与 inquiry 结果一致）
bankCode	string	Yes	银行代码（如 BCA、BNI、BRI）
amount	number	Yes	转账金额（印尼盾）
merchantTrxId	string	Yes	商户侧唯一交易 ID
platformTrxId	string	Yes	来自 Account Inquiry 的 platformTrxId
notifyUrl	string	Yes	用于接收转账状态通知的 webhook URL

银行代码参考

完整银行/电子钱包代码请见 Bank List。

示例请求

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

成功响应

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

响应字段

Field	Description
merchantTrxId	商户交易 ID
platformTrxId	KingsPay 平台交易 ID
status	初始状态（通常 pending），最终状态会通过 webhook 推送到 notifyUrl

Webhook

转账最终状态（success/failed）会发送到您提供的 notifyUrl。请确保 webhook 端点可正常接收并处理通知。