Account Inquiry

在转账前校验收款银行账号。必须先调用此接口，再调用转账接口，以确保账户信息正确。

Endpoint

POST /api/v1/disbursement/account-inquiry

Request Body

Parameter	Type	Required	Description
merchantTrxId	string	Yes	商户侧唯一交易 ID
accountNo	string	Yes	收款账号
bankCode	string	Yes	银行代码（例如 BNI、BCA、BRI）
amount	number	Yes	转账金额（印尼盾）

银行代码参考

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

示例请求

{
  "merchantTrxId": "{{requestId}}",
  "accountNo": "123456789",
  "bankCode": "BNI",
  "amount": 10000
}

成功响应

{
  "logId": "ldTAIkiZwBDblWyCN8OE",
  "status": true,
  "message": "Inquiry success",
  "data": {
    "merchantTrxId": "2026012504373574936905643",
    "platformTrxId": "2026012421374086207",
    "accountNo": "123456789",
    "accountName": "Brianne Hyatt",
    "bankCode": "BNI",
    "amount": 10000
  }
}

响应字段

Field	Description
merchantTrxId	商户交易 ID
platformTrxId	KingsPay 平台交易 ID
accountNo	账号
accountName	账户姓名（转账时必须一致）
bankCode	银行代码
amount	待转账金额

代付流程

1. 先调用 Account Inquiry 校验账户，并获取 accountName 与 platformTrxId
2. 使用相同的 accountName 与 platformTrxId 调用 Transfer