SPEI
Overview
| Property | Details |
|---|---|
| Markets (consumer) | MX |
| Consumer currencies | MXN |
| Authentication methods | REDIRECT |
| Authentication timeout | 1 day |
| Minimum payment amount | 1 MXN |
| Maximum payment amount | Subject to channel rules |
| Payment instrument | BANK_TRANSFER |
| Recurring payments | No |
| Separate captures | No |
| Refund | Full / Partial |
| Refund validity | 180 Days |
| Disputes | No |
Payment flow
1.
2.
3.
4.
Notes
MX).return_url does not mean the payment succeeded. Treat the webhook as the final status.Supported Transaction Types
Product Support
Supported Countries
One-time Payment
Required Fields
| Field | Required | Description |
|---|---|---|
payment_method_data.type | Required | Must be spei. |
payment_method_data.spei.identification_number | Required | Payer's Mexican national ID number (CURP 10–18 or RFC 12–13 characters). |
payment_method_data.billing.email | Required | Payer email address. |
payment_method_data.billing.first_name | Required | Payer first name. |
payment_method_data.billing.last_name | Required | Payer last name. |
payment_method_data.billing.address.country | Required | Use MX. |
return_url | Required | URL to return the customer after payment. |
device_data.ip_address | Required | Customer IP address for risk analysis. |
Create and Confirm a PaymentIntent
next_action.redirect pointing to the UseePay-hosted SPEI payment instruction page.{
"id": "1012609070000000001",
"status": "requires_customer_action",
"currency": "MXN",
"amount": 100,
"next_action": {
"type": "redirect",
"redirect": {
"method": "GET",
"url": "https://checkout.useepay.com/spei?session=pmr_xxx&pid=pi_xxx"
}
}
}