Mexico SPEI

Production

https://api.paypaga.com

POST

/v2/transactions/pay-out

Required Fields

Field	Description	Validation
name	Full name of the beneficiary	<= 40 characters
document_number	Beneficiary identifier. RFC (Registro Federal de Contribuyentes) / CURP (Clave Única de Registro de Población)	Valid RFC / CURP
email	Email address of the beneficiary	Length >= 5 <= 50, RegEx `^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$`
account_number	Account number of the beneficiary (CLABE)	Valid CLABE
account_type	Beneficiary account type	Must be 40
bank_code	Destination bank institution code (e.g.: 40133), code list: https://www.banxico.org.mx/cep-scl/listaInstituciones.do	RegEx `^\d+$`
payout_concept	Brief description for the transaction

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://api.paypaga.com/oauth2/token

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Pay-out accepted for processing.

Headers

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paypaga.com/v2/transactions/pay-out' \
--header 'Content-Type: application/json' \
--data-raw '{
    "country": "MX",
    "currency": "MXN",
    "payment_method": "spei",
    "merchant_transaction_reference": "TRX-2026-0026",
    "merchant_order_reference": "ORDER-2026-0001",
    "merchant_customer_id": "customer@mail.com",
    "customer_ip": "120.29.48.92",
    "amount": 125.5,
    "fields": {
        "name": "Eryn Rogahn",
        "document_number": "12234514789",
        "email": "customers@email.com",
        "account_number": "123456789012345678",
        "account_type": "40",
        "bank_code": "90646",
        "payout_concept": "payment"
    }
}'

Response Example

{
    "transaction_id": "20240806-2010-4086-8342-c28f4979f834",
    "merchant_transaction_reference": "TRX-2026-0026",
    "merchant_order_reference": "ORDER-2026-0001"
}

Modified at 2026-06-09 15:01:50

Guatemala Bank Transfer

Peru Bank Transfer