Bank Account Validation

Check if a bank account is valid. Use this service before sending a request in order to avoid transaction rejection due to data mismatch.

Bank Account Validation

POST https://api.stage.localpayment.com/api/validation/bank

Request Body

Name	Type	Description
country*	String	Mantory. Country of the bank account to be validated. Country ISOCode3 format.
bank*	Object	Mandatory. Bank object.
bank.code*	String	Mandatory. Bank code, according to Localpayment bank codes list.
branch	Object	Branch object. Only mandatory for brazilian's bank account
branch.code	String	Branch code. Only mandatory for brazilian's bank account. It lenght should be between 1 to 5 characters
bank.account*	Object	Mandatory. Account object.
bank.account.number*	String	Mandatory. Bank account number.
type*	String	Mandatory. Bank account type. It has to be "C" for "ckeching" or "S" for "saving". In Chile and Peru have more account types.

200: OK Validation succesfully sent, it can return validation errors or validation sucess messages

    {
        "code": "200",
        "description": "Valid bank code and account number"
    }

400: Bad Request Invalid bank account, bank code, branch code or country

Validation Error Codes Please find all the possible error codes in this link

{
    "code": "404",
    "description": "bank code doesn't exist"
}

Bank Account Validation: Example request

Below there are two sample requests, both in json and curl format. The first request example is to validate bank accounts from all the countries that LP works with, except Brazil. The second example is therefore to validate Brazilian bank accounts.

JSON: Example request

{
    "country" : "ARG",
    "bank" : {
        "code" : "191",
        "account" : {
            "number" : "1910119655111901676653",
            "type" : "s"
        }
    }
}

cURL: Example request

curl --location --request POST 'https://api.stage.localpayment.com/api/validation/bank' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjQ2Njc3NTY4LCJqdGkiOiJkMDM5MDAzZGUwOTQ0OGI3YTM2NjU0MDk4M2FlYTg0ZCIsInVzZXJfaWQiOjMwLCJzdXBlcnVzZXIiOnRydWUsImlzX3N0YWZmIjpmYWxzZSwicm9sZXMiOlsiQUxMIl0sImNvdW50cmllcyI6WyJBTEwiXSwiY29tcGFueSI6IjAwMDEiLCJjbGllbnRfY29kZSI6IjAwMDEifQ.DOceicigffhfAVjvldfpi2D5byOp_pEYr5Sq3b_kp7Q' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country" : "ARG",
    "bank" : {
        "code" : "191",
        "account" : {
            "number" : "1910119655111901676653",
            "type" : "s"
        }
    }
}'

BRA: Example request (JSON)

{
    "country" : "BRA",
    "bank" : {
        "code" : "341",
         "branch": {
               "code" : "6393"
           },
        "account" : {
            "number" : "217309",
            "type" : "S"
        }
    }
}

BRA: Example request (cURL)

curl --location --request POST 'https://api.stage.localpayment.com/api/validation/bank' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjQ2Njc3OTIyLCJqdGkiOiIxNzk1YWY3MTdkMTE0ZjAwYmYwNmY3YTVmYzRjZGY3NCIsInVzZXJfaWQiOjMwLCJzdXBlcnVzZXIiOnRydWUsImlzX3N0YWZmIjpmYWxzZSwicm9sZXMiOlsiQUxMIl0sImNvdW50cmllcyI6WyJBTEwiXSwiY29tcGFueSI6IjAwMDEiLCJjbGllbnRfY29kZSI6IjAwMDEifQ.RjbPtAOJ8RSqa3HWdB0vZb4uWLbW5gS_ODu62BOgVNc' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country" : "BRA",
    "bank" : {
        "code" : "341",
         "branch": {
               "code" : "6393"
           },
        "account" : {
            "number" : "217309",
            "type" : "S"
        }
    }
}'

Examples: Bank account validations response

Status OK

{
    "code" : "200",
    "description" : "Valid bank code and account number"
 
}

Bad Request

{
    "code": "701",
    "description": "Bank code not found"
}

Please Check all the possible error codes in this link

Validation Error Codes

Check the CountryISO Code3 in the following section:

Country Codes

Check our bank code list in the following section

Bank codes

Check the bank account validations requirements in each country in the following section:

Bank account validations