México
Mexico is one of the most dynamic payment markets in Latin America. It offers a robust infrastructure of both traditional and alternative payment methods, making it a strategic country for digital platforms and high-volume industries
With our solution, your business can accept a wide range of Pay In methods, including credit/debit cards, real-time bank transfers via SPEI, and extensive cash-based networks like OXXO Pay and other retail partners, providing broad accessibility for Mexican users regardless of their banking status.
Please note that the process is always the same, before processing the transaction you must create the order, here is an example of the body for this country.
{
"country": "MEX",
"origin": "api",
"amount": "25",
"email": "test@gmail.com"
}
Pay In
Credit card
Once the order has been successfully created, you can proceed to process the card transaction. The system will return a checkout URL to which the customer will be redirected to enter their contact information and card details. This information is required to complete the transaction.
All card transactions are enabled with 3DS (3D Secure). Any card not enrolled in 3DS will not be processed.
Type Transaction | Type Payment | Payment Method | Supported Providers | Logos |
---|---|---|---|---|
card+ | credit / debit | tc | Visa, Mastercard | ![]() ![]() |
Complete Transaction - Body (Sample Request)
{
"hash": "U2FsdGVkX1+MXCardTxnEncryptedHash...",
"paymentMethod": "tc",
"typePayment": "credit",
"typeTransaction": "card+",
"merchantId": "mx-merchant-id-1234",
"urlReturn": "https://tusitio.com/retorno"
}
Test Cards
Use the following test card numbers to simulate different card transaction scenarios in the sandbox environment. These cards only work in test mode and do not generate actual payments.
Card Number | CVV | Expiry Date | Result |
---|---|---|---|
4242424242424846 | 123 | 12/29 | Successful transaction |
4242424242424341 | 123 | 12/29 | Declined transaction |
4032037236725541 | 123 | 12/29 | Card does not allow 3DS validation |
Bank Transfer
Type Transaction | Type Payment | Payment Method | Supported Providers | Logos |
---|---|---|---|---|
bankin | bank | spei | SPEI | ![]() |
Complete transaction - Body (Sample Request)
{
"hash": "U2FsdGVkX19oU6%....",
"paymentMethod" : "spei",
"typePayment" : "bank",
"typeTransaction":"bankin",
"description" : "Test order",
"customer": {
"typeDocument":"DNI",
"document" : "1234567890",
"name": "Juan",
"lastName":"Pérez",
"phoneNumber":"3133133131"
},
"address": {
"line1": "123 First Street",
"line2": "",
"countryCode": "US",
"stateProvince": "FL",
"city": "Orlando",
"postalCode": "32830"
},
}
Cash
Type Transaction | Type Payment | Payment Method | Supported Providers | Logos |
---|---|---|---|---|
cashin | cash | kiosko | KIOSKO | ![]() |
walmart | Walmart | ![]() | ||
systienda | SysTienda | ![]() | ||
bodegaaurrea | Bodega Aurrera | ![]() | ||
eleven | Eleven | ![]() | ||
oxxopay | Oxxo Pay | ![]() |
Complete transaction - Body (Sample Request)
{
"hash": "U2FsdGVkX19oU6%....",
"paymentMethod" : "kiosko",
"typePayment" : "cash",
"typeTransaction":"cashin",
"description" : "Test order",
"customer": {
"typeDocument":"DNI",
"document" : "1234567890",
"name": "Juan",
"lastName":"Pérez",
"phoneNumber":"3133133131"
},
"address": {
"line1": "123 First Street",
"line2": "",
"countryCode": "US",
"stateProvince": "FL",
"city": "Orlando",
"postalCode": "32830"
},
}
Wallet
Paypal
This endpoint allows you to initiate a payment process with PayPal through our API.
We will generate a checkout URL where the customer can be redirected to securely complete the payment process.
Complete transaction - Body (Sample Request)
{
"hash": "U2FsdGV...",
"paymentMethod": "paypal",
"typePayment": "wallet",
"typeTransaction": "walletin",
"merchantId": "564153131",
"urlReturn": "https://google.com",
"urlRejected": "https://youtube.com",
"urlWebhook": "https://webhook/ok"
}
Aditional Notes
- The merchant must redirect the user to the
payer-action
URL immediately after receiving the response.- Do not rely solely on user redirection to confirm the payment; always validate the final payment status using the webhook.
💰 Fees & Rates
These are the applicable processing fees (before VAT and any other taxes) for transactions in Mexico.
Payment Method | Type | Providers | Fee |
---|---|---|---|
💳 Credit/Debit Cards | Pay In | ![]() | 2.99% + 0.18 USD |
🏦 Bank Transfer | Pay In | ![]() | 1% + 0.5 USD |
💸 APMs | Cash In | ![]() ![]() ![]() ![]() | 3.5% + 0.75 USD |