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 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 |
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 |