Validate Bank Account


Check if an account is valid, if valid return account information.


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



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