Bank Account Validation

Welcome to the bank account validation documentation. This API will allows you to verify if a bank account is valid or not.

Overview

The Bank Validation API was designed to provide you with the core functionality of verifying the authenticity of bank accounts. This API allows you to validate bank key numbers, ensuring that they are legitimate and in compliance with banking standards. With this tool, you will be able to obtain information about the validity of an account, its holder and other relevant details.

Validate Bank Account

Initiates the bank account validation process based on an interbank CLABE, owner's name and bank.

Endpoint: POST ~/api/BankAccountValidation/ValidateBankAccount

Headers:

Tag Type Required Description
apikey string yes Customer key.
  • ApiKey (string, required): Customer key for authentication.

Parameters FromBody:

Tag Type Required Description
clabe string Yes The interbank CLABE.
name string Yes The owner's name.
bank number Yes The account’s bank. See list below.
{
  "clabe": "string",
  "name": "string",
  "bank": 0
}

Request:

curl --location '~/api/BankAccountValidation/ValidateBankAccount'
--header 'ApiKey: _apiKeyValue_'
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--data '{
    "clabe": 0,
    "name": "string",
    "bank": 0
}'

Response:

200 Success

{
  "VerificationId": "string",
  "Name": "string",
  "CLABE": "string",
  "Status": "status"
}
Response:
Name Type Description
VerificationId string Transaction ID
Name string Owner's name
CLABE string CLABE to validate
Status string Validation status

Error Response

Name Type Description
Code string Error code
Message string Error Message
StatusCode int Status Code returned
{
  "code": "string",
  "message": "string",
  "statusCode": 0
}

Get Validation Status

Allows the search of a transaction to verify the validation status based on the transaction ID.

Endpoint: GET ~/api/BankAccountValidation/VerificationStatus

Headers:

Tag Type Required Description
apikey string yes Customer key.
  • ApiKey (string, required): Customer key for authentication.

Parameters FromQuery:

Tag Type Required Description
VerificationId string Yes Transaction ID.

Request:

curl --location '~/api/BankAccountValidation/verificationStatus?VerificationId=XXX'
--header 'ApiKey: _apiKeyValue_'
--header 'Content-Type: application/json'
--header 'Accept: application/json'

Response:

200 Success

{
  "VerificationId": "string",
  "VerificationStatus": 0,
  "Verification": {
    "Valid": true,
    "Data": {
      "Name": "string",
      "CLABE": "string",
      "FI": 0,
      "Status": "string"
    }
  }
}
Response:
Name Type Description
VerificationId string Transaction ID.
verificationStatus int Status of verification. 1.- Processing, 2.- Retrying, 3.- Delivering, 4.- Completed.
verification
Valid bool Indicates whether an account is valid or not.
data
Name string Owner's name.
CLABE string CLABE to validate.
FI number The account’s bank. See list below.
Status string Validation status.

Error Response

Name Type Description
Code string Error code
Message string Error Message
StatusCode int Status Code returned
{
  "code": "string",
  "message": "string",
  "statusCode": 0
}

Financial Institutions Catalog

Code Financial Institution
2001 BANXICO
37006 BANCOMEXT
37009 BANOBRAS
37019 BANJERCITO
37135 NAFIN
37166 BaBien
37168 HIPOTECARIA FED
40002 BANAMEX
40012 BBVA MEXICO
40014 SANTANDER
40021 HSBC
40030 BAJIO
40036 INBURSA
40042 MIFEL
40044 SCOTIABANK
40058 BANREGIO
40059 INVEX
40060 BANSI
40062 AFIRME
40072 BANORTE
40106 BANK OF AMERICA
40108 MUFG
40110 JP MORGAN
40112 BMONEX
40113 VE POR MAS
40127 AZTECA
40128 AUTOFIN
40129 BARCLAYS
40130 COMPARTAMOS
40132 MULTIVA BANCO
40133 ACTINVER
40136 INTERCAM BANCO
40137 BANCOPPEL
40138 ABC CAPITAL
40140 CONSUBANCO
40141 VOLKSWAGEN
40143 CIBANCO
40145 BBASE
40147 BANKAOOL
40148 PAGATODO
40150 INMOBILIARIO
40151 DONDE
40152 BANCREA
40154 BANCO COVALTO
40155 ICBC
40156 SABADELL
40157 SHINHAN
40158 MIZUHO BANK
40159 BANK OF CHINA
40160 BANCO S3
90600 MONEXCB
90601 GBM
90602 MASARI
90605 VALUE
90608 VECTOR
90616 FINAMEX
90617 VALMEX
90620 PROFUTURO
90630 CB INTERCAM
90631 CI BOLSA
90634 FINCOMUN
90638 NU MEXICO
90642 REFORMA
90646 STP
90652 CREDICAPITAL
90653 KUSPIT
90656 UNAGRA
90659 ASP INTEGRA OPC
90661 ALTERNATIVOS
90670 LIBERTAD
90677 CAJA POP MEXICA
90680 CRISTOBAL COLON
90683 CAJA TELEFONIST
90684 TRANSFER
90685 FONDO (FIRA)
90686 INVERCAP
90689 FOMPED
90703 TESORED
90710 NVIO
90722 Mercado Pago W
90723 CUENCA
90902 INDEVAL
90903 CoDi Valida
91812 BBVA BANCOMER2*
91814 SANTANDER2*
91821 HSBC2*
91927 AZTECA2*
91872 BANORTE2*
90706 ARCUS
91802 BANAMEX2

Service messages

Message Code Message Description
BAV001 Internal Server Error. An internal server error has occurred.
BAV002 Authentication Error. API key is missing or invalid.
BAV003 Clabe Error. The CLABE is incorrect or null.
BAV003 Name Error. The Name is incorrect or null.
BAV003 FI Error. The financial institution is incorrect or null.
BAV004 Resource not found. Resource not found.
BAV005 Bad Request. Invalid Input Parameter.
BAV006 Unauthorized. Authentication Error.
BAV007 Server Unavailable. The service is under maintenance, please try again later.
BAV008 TimeOut Error. TimeOut Server Connection Error.
BAV009 Response Format Error. Incorrect response format.
BAV010 Validation Error. An error occurred while generating the validation..
BAV011 ID Error. The Id is incorrect or null.
BAV011 Estado Error. The Estado is incorrect or null.
BAV012 Error Update status. Error updating status.