This endpoint checks if a bank account exists and retrieves basic details—such as account name and number. It does not indicate whether the account is blocked, dormant, or has any other issues from the bank's side.
curl -X GET \
'BASE_URL/api/v1/account_validation?bank=danamon&account=000001137298' \
-H 'Accept: application/json' \
-H 'Authorization: Basic AUTH_STRING' \
-H 'Cache-Control: no-cache'
{
"id": "e2c60cbd3c7a453bbc843b1f2b2e9027",
"account_name": "Danamon Simulator A",
"account_no": "000001137298",
"bank_name": "danamon"
}
{
"id": "e2c60cbd3c7a453bbc843b1f2b2e9025",
"error_message": "An error occured when doing account validation",
"errors": {
"account": [
"Account does not exist"
]
}
}
{
"error_message": "You are not authorized to perform this action",
"errors": {
"account": [
"You are not authorized to perform this action"
]
}
}
{
"id": "e2c60cbd3c7a453bbc843b1f2b2e9023",
"error_message": "An error occured when doing account validation",
"errors": {
"account": [
"Bank account validation is currently unavailable"
]
}
}
Here is the list of error_message
that you can get from this API
Response code | Error Message | Notes |
---|---|---|
400 | Account does not exist | Account does not exist in bank system |
400 | Account is dormant | Account has become dormant in bank system |
400 | Account is closed | Account has closed in bank system |
401 | You are not authorized to perform this action | Authentication error |
503 | Bank account validation is currently unavailable | System error |
429 | Too many requests | Merchant send too many request within timeframe (1 second) |
Rate Limit
For Create Payout, Approve Payout, and Account Validation endpoints, a rate limit of 50 requests per second (RPS) per merchant will be enforced in production.
HTTP
GET BASE_URL/api/v1/account_validation?bank=#{BANK_NAME}&account=#{BANK_ACCOUNT}
Request Parameters
Parameter | Description |
---|---|
bank | Bank code |
account | Account number |
Response Parameters
Parameter | Description |
---|---|
bank_name | Bank name of partner's bank account |
account_name | Account name of partner's bank account |
account_no | Account number of partner's bank account |
id | Unique ID of the Account Validation |