Overview
Mexico PayOut operates exclusively through SPEI (Sistema de Pagos Electrónicos Interbancarios), the interbank real-time settlement network operated by Banco de México. Disbursements are processed asynchronously — the API returns aPENDING status immediately, and the final result (APPROVED or REJECTED) is delivered via webhook.
SPEI supports two destination account types:
Quick Reference
Common Request Fields
Both transfer types share the same top-level fields and basecustomer_data fields. The only difference is in the account-specific fields documented in each section below.
Top-level Fields
Base Customer Data Fields
These fields are required for both account types:SPEI via CLABE
Use this flow to disburse funds to any Mexican bank account identified by its 18-digit CLABE number.Additional Fields
The
clabe_number must be exactly 18 digits. CLABE uniquely identifies the destination bank branch and account within Mexico’s SPEI network. Incorrect CLABEs will result in rejected transfers.CLABE validation
Whenaccount_type is "CLABE", the API validates clabe_number and account_number before the transaction is created. A CLABE is read by position:
clabe_number
- Must contain exactly 18 digits (numbers only, no spaces or dashes).
- The check digit (position 18) must be valid. It is calculated by multiplying each of the first 17 digits by the weights
3, 7, 1, 3, 7, 1, …, adding the products, and taking(10 - (sum mod 10)) mod 10. bankmust be present.
account_number
- Must contain 10 to 12 digits (numbers only). Sending the full 18-digit CLABE in
account_numberis rejected. - Must be the account segment of
clabe_number, in one of these formats:
The account segment is only compared once both
account_number and clabe_number pass the rules above.
Validation errors
If a rule fails, the API responds with HTTP 422 and does not create the transaction. Only the first error is returned inmessage:
The example CLABE
012180012345678909 is synthetic: it passes the validation but does not belong to a real account. Use it only to test the request format.Request Example
SPEI via Tarjeta Débito
Use this flow to disburse funds directly to a Visa or Mastercard debit card number, without needing a CLABE.Additional Fields
Only debit cards (Visa or Mastercard) are supported for this transfer type. Credit cards will be rejected.