Validate Bank Account

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 codeError MessageNotes
400Account does not existAccount does not exist in bank system
400Account is dormantAccount has become dormant in bank system
400Account is closedAccount has closed in bank system
401You are not authorized to perform this actionAuthentication error
503Bank account validation is currently unavailableSystem error
429Too many requestsMerchant 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


ParameterDescription
bankBank code
accountAccount number



Response Parameters


ParameterDescription
bank_nameBank name of partner's bank account
account_nameAccount name of partner's bank account
account_noAccount number of partner's bank account
idUnique ID of the Account Validation