🇲🇽Mexico

Check the requirements and validations made over the cashouts on Mexico

Required fields

Field	Format	Description
login	String	Cashouts login
pass	String	Cashouts pass
external_id	String (max length: 100)	Transaction's ID on your end
document_id	See document validations	Beneficiary's document ID
country	MX	See country codes
currency	MXN / USD	See currency codes
amount	Number with up to 2 decimals	Cashout amount
bank_code	See bank codes	Code specifying the beneficiary's bank. Only mandatory if the bank_account is a debit card
bank_account	See validations below	Beneficiary's bank account
beneficiary_name	String (max length: 100)	Beneficiary's name
beneficiary_lastname	String (max length: 100)	Beneficiary's last name

Bank Account Validations

Bank name	Bank code	Format	Example
All	-	CLABE: 18 digits long, applies verifier algorithm.	021790064060296642
All	-	DEBIT CARD: 15-16 digits long, applies verifier algorithm. Can only be sent through the Cashout to Debit Cards Endpoint.	5344867217683750
Todito	10000	10 digits long.	2682883311
Kiosko	10008	Empty String	-

CLABE validation algorithm

Click here for more information about CLABE format.

Since the first three digits of the CLABE are the bank code, it is not mandatory to send the bank_code field.

Java

Mexico CLABE validation algorithm in Java

public final class Validations {
    static int CLABE_LENGTH = 18;
    
    private static boolean validateClabeLength(String bankAccount) {
        return bankAccount.length() == CLABE_LENGTH;
    }
    
    private static boolean validateClabe(String clabe) {
        if (!validateClabeLength(clabe)) {
            return false;
        } else {
            int sum = 0;
            String clabeWithoutCd = clabe.substring(0, 17);
            Integer[] array = new Integer[]{3, 7, 1};
    
            int checkDigitToVerify;
            for(checkDigitToVerify = 0; checkDigitToVerify < clabeWithoutCd.length(); ++checkDigitToVerify) {
                int digit = clabeWithoutCd.charAt(checkDigitToVerify);
                sum += digit * array[checkDigitToVerify % 3] % 10;
            }
    
            checkDigitToVerify = (10 - sum % 10) % 10;
            int checkDigit = Integer.parseInt(clabe.substring(17));
            return checkDigitToVerify == checkDigit;
        }
    }
}

Document Validations

Click here to check document types and validations.

Example Request

{
    "login": "xxxxxxxx",
    "pass": "xxxxxxxx",
    "external_id": "30000000001",
    "country": "MX",
    "currency": "MXN",
    "amount": 100,
    "document_id": "848392783",
    "bank_account": "021790064060296642",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}

Bank codes

Notice that the bank_code for Mexico is only mandatory if the bank_account length is between 15 and 16 (Debit Card). In that case, use the Credit Cards endpoint: https://cc-api-stg.directa24.com/v3/cashout

For the full and most up-to-date list of banks and its codes, please check the Cashout Bank Code endpoint.