Bank Account Validation

Bank account validation service based on the Interbank CLABE, the account holder's name, and the banking institution's name.

It provides the core functionality of verifying the authenticity of bank accounts. This API allows you to validate bank account numbers (CLABE), ensuring their legitimacy and compliance with banking standards. With this tool, you can obtain information about the validity of an account, its holder, and other relevant details.

Common Use Cases

---

1. Identity Verification (KYC): Confirm an individual's identity.
2. Regulatory Compliance: Ensure financial institutions operate under legal standards, minimizing internal errors and improving fiscal transparency.
3. Payment Authorization: Easily verify a CLABE for automatic payments to employees and/or suppliers before initiating transfers, preventing input errors and ensuring funds reach the correct recipient, avoiding returns and delays.
4. Fraud Prevention: Verify that the CLABE account does not belong to a different individual.
5. Direct Debit Setup: Validate whether charges can be processed against the account provided by the customer.

Base URL

https://web-prod01.tuidentidad.com

Authentication

Headers:

Tag	Type	Required	Description
apikey	string	yes	Customer key for authentication.

Endpoint:

Method	Endpoint	Description
POST	/api/CTBancaria/account-validation	Bank account validation service

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

Request body

Tag	Type	Required	Description
clabe	string	Yes	The interbank CLABE.

{
  "clabe": "string",
}

Request:

curl --location 'https://web-prod01.tuidentidad.com/api/CTBancaria/account-validation' \
  --header 'ApiKey: _apiKeyValue_' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
    "clabe": "XXXXXXXXXXXXXXXXXX"
  }'

Response:

200 Success

{ 
  "valid": true, 
  "data": { 
    "accountNumber": "999000000000000001", 
    "bankName": "TEST_PROVIDER", 
    "countryCode": "MX", 
    "beneficiaryName": "JUAN PEREZ", 
    "accountCurrency": "MXN" 
  }, 
  "warnings": null 
} 

Response:

Field	Type	Description
valid	Boolean	Indicates whether the request was successful
data.accountNumber	Integer	Bank account number
data.bankName	String	Name of the bank
data.countryCode	String	Country code
data.beneficiaryName	String	Name of the account holder
data.accountCurrency	String	Account currency
warnings	Array	List of warning messages

Error Response

Name	Type	Description
type	string	Type
title	string	Message
status	integer	HTTP code
detail	string	Detail of the error
code	string	Error code

JSON

{ 
  "type": "https://docs.tuidentidad.com/CTBancaria-account-validation/", 
  "title": "Invalid CLABE format", 
  "status": 400, 
  "detail": "Invalid CLABE format", 
  "code": "CTB001" 
} 

Service messages

Code	Description	HTTP Status code
CTB001	Invalid CLABE format	400
CTB002	Provider communication error	503
CTB003	Internal server error	500
CTB004	Missing required header	400
CTB005	Empty CLABE value	400
CTB100	Account not found	200
CTB101	Bank rejected the request	200
CTB102	Account invalid per provider	200
CTB401	Unauthorized	401