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.
fi	number	Yes	The financial institution of the account. See list below.

{
  "clabe": "string",
  "name": "string",
  "fi": 0
}

Request:

curl --location '~/api/BankAccountValidation/ValidateBankAccount'
--header 'ApiKey: _apiKeyValue_'
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--data '{
    "clabe": 0,
    "name": "string",
    "fi": 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/BAValidation/GetValitationStatus

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
    }
  },
  "warnings": ["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.
Warnings	List	List of errors.

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.