Skip to main content

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 a PENDING 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 base customer_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

When account_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.
  • bank must be present.
The API does not compare the bank code (positions 1–3) with the bank field. Make sure bank is the institution identified by the first three digits of the CLABE (for example, 012 → BBVA_MEXICO).
account_number
  • Must contain 10 to 12 digits (numbers only). Sending the full 18-digit CLABE in account_number is 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 in message:
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.

Request Example


Response Structure

Success Response

Data Object

Transaction Status Flow

Response Example