Skip to main content
POST
/
api
/
v2.0
/
disbursement
/
check-beneficiary
Check beneficiary
curl --request POST \
  --url https://sandbox-payment-b2b.singapay.id/api/v2.0/disbursement/check-beneficiary \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-PARTNER-ID: <api-key>' \
  --data '
{
  "bank_code": "002",
  "bank_account_number": "1234567890000"
}
'
{
  "response_code": "SP000",
  "response_message": "Successfully",
  "data": {
    "bank_code": "002",
    "bank_account_number": "12345678",
    "status": "valid",
    "bank_account_name": "JOHN DOE",
    "bank_name": "BRI"
  }
}

Authorizations

​
Authorization
string
header
required

JWT issued by POST /api/v1.1/access-token/b2b. Send Authorization: Bearer <token>.

​
X-PARTNER-ID
string
header
required

Merchant API key (Credential.api_key). Required on every request.

Body

application/json

Request body for beneficiary account name inquiry (API v2.0).

​
bank_code
string
required

Destination bank identifier: a three-digit national bank code (for example 014) or an eight-character SWIFT code (for example BRINIDJA).

Example:

"002"

​
bank_account_number
string
required

Beneficiary account number. Numeric digits only, between 6 and 30 characters.

Example:

"1234567890000"

Response

SP000 Successfully — beneficiary verified. Merchant action: none required before transfer.

Custom v2 envelope for check beneficiary. response_code is SP000 when valid (HTTP 200) or SP014 when verification fails (HTTP 404).

​
response_code
string
required

SingaPay custom business response code.

Example:

"SP000"

​
response_message
string
required

Human-readable label paired with response_code.

Example:

"Successfully"

​
data
object
required

data for disbursement v2 check beneficiary. Echoes request fields plus inquiry result.