Validate BIN

Check if a debit / credit card is valid. Use this service before sending a payment request to avoid transaction rejection due to data mismatch.

Validate BIN

GET http://api.stage.localpayment.com/api/resources/bin-validation?bin=

Check whether a card BIN (first six digits) is valid and look up the associated data.

Query Parameters

Name	Type	Description
bin*	string	Mandatory. Card BIN (first six digits).

Headers

Name	Type	Description
Authorization*	string	Mandatory. JWT token in format Bearer eyj0.... For more information about authentication, please refer to Authentication.

200: OK Valid Card BIN and its associated data

{
    "bin": "379911",
    "bank": "SANTANDER MEXICO",
    "card": "AMERICAN EXPRESS",
    "type": "CREDIT",
    "level": "PERSONAL PLATINUM REVOLVE",
    "country": "MEXICO",
    "countryCode": "MX",
    "website": "",
    "phone": "",
    "valid": "true",
    "error": null
}

400: Bad Request Card BIN is invalid.

Example: Validate BIN

cURL request

curl --location --request GET 'https://api.stage.localpayment.com/api/resources/bin-validation?bin=492962' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjUxMDkwODY3LCJqdGkiOiIwYjJiMjUzMDJlYzc0NDE4YjdlYzE4MTgzNGQ2NjY5ZiIsInVzZXJfaWQiOjMwLCJzdXBlcnVzZXIiOnRydWUsImlzX3N0YWZmIjpmYWxzZSwicm9sZXMiOlsiQUxMIl0sImNvdW50cmllcyI6WyJBTEwiXSwiY29tcGFueSI6IjAwMDEiLCJjbGllbnRfY29kZSI6IjAwMDEifQ.NT4hMEoqCK5QzjEJwSmg7Pp9lDCEydQiv9ZwkA1HR1A'

Response

{
    "bin": "492962",
    "bank": "BARCLAYS BANK PLC",
    "card": "VISA",
    "type": "CREDIT",
    "level": "GOLD",
    "country": "URUGUAY",
    "countryCode": "UY",
    "website": "",
    "phone": "",
    "valid": "true",
    "error": null
}

Notice that the Country Code given in the response is in CountryIsoCode2.

Please, remember that our system works with CountryIsoCode3