Mexico SPEI
Production
https://api.paypaga.com
Production
https://api.paypaga.com
POST
/v2/transactions/pay-in
Conditional Fields
| Field | Description | Validation |
|---|---|---|
| document_number | RFC (Registro Federal de Contibuyentes) or CURP (Clave Única de Registro de Población) required if account configured for CLABE per user |
Optional Fields
| Field | Description | Validation |
|---|---|---|
| first_name | First name | |
| last_name | Last name |
Response Fields
| Field | Description |
|---|---|
| amount | Amount the customer must transfer via SPEI; matches the requested transaction amount and should be confirmed by the customer before completing the transfer. |
| bank_account | 18-digit CLABE interbank account number the customer must register as the destination account (see step 1 in Payment Instructions below). |
| beneficiary | Name of the receiving account holder, shown by the bank once the CLABE is validated. |
| reference | Payment concept ("Concepto") the customer must enter with the transfer (see step 1 below); used to match the incoming payment to this transaction. |
Expiry
Payment Instructions
1.
2.
3.
1.
2.
3.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.paypaga.com/v2/transactions/pay-in' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 1000,
"country": "MX",
"currency": "MXN",
"customer_ip": "120.29.48.92",
"fields": {
"document_number": "12234514789",
"first_name": "Juan",
"last_name": "Pérez"
},
"merchant_customer_id": "customer@email.com",
"merchant_order_reference": "ORDER-2026-0027",
"merchant_transaction_reference": "TRX-2026-0027",
"payment_method": "spei",
"return_urls": {
"failure_url": "https://merchant.com/payment-failure",
"success_url": "https://merchant.com/payment-success"
}
}'Response Response Example
201 - Mexico SPEI
{
"expires_at": "2026-06-09T14:13:05.143073869Z",
"instructions": {
"amount": 1000,
"bank_account": "646180554000010079",
"beneficiary": "OYSTER_LOAN",
"reference": "H59PUBPV"
},
"payment_method_reference": "129930",
"transaction_id": "20260209-0920-4e80-9bcf-49f6503dd1ca"
}Modified at 2026-09-07 15:42:44