Account Inquiry

Validates bank account number before making a transfer. Must be called before the transfer endpoint to ensure account details are correct.

Endpoint

POST /api/v1/disbursement/account-inquiry

Request Body

Parameter	Type	Required	Description
merchantTrxId	string	Yes	Unique transaction ID from merchant
accountNo	string	Yes	Destination account number
bankCode	string	Yes	Bank code (e.g., BNI, BCA, BRI)
amount	number	Yes	Transfer amount (in Rupiah)

Example Request

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

Success Response

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

Response Fields

Field	Description
merchantTrxId	Merchant transaction ID
platformTrxId	KingsPay platform transaction ID
accountNo	Account number
accountName	Account holder name (must match when transferring)
bankCode	Bank code
amount	Amount to be transferred

Disbursement Flow

1. Call Account Inquiry to validate the account and get accountName and platformTrxId
2. Use that data to call Transfer with the same accountName and platformTrxId