Skip to main content

MéxicoMé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.

tip

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.

warning

All card transactions are enabled with 3DS (3D Secure). Any card not enrolled in 3DS will not be processed.

Type TransactionType PaymentPayment MethodSupported ProvidersLogos
card+credit / debittcVisa, Mastercard 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 NumberCVVExpiry DateResult
424242424242484612312/29Successful transaction
424242424242434112312/29Declined transaction
403203723672554112312/29Card does not allow 3DS validation

Bank Transfer

Type TransactionType PaymentPayment MethodSupported ProvidersLogos
bankinbankspeiSPEISPEI

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 TransactionType PaymentPayment MethodSupported ProvidersLogos
cashincashkioskoKIOSKOKIOSKO
walmartWalmartWalmart
systiendaSysTiendaSysTienda
bodegaaurreaBodega AurreraBodega Aurrera
elevenElevenEleven
oxxopayOxxo PayOxxo 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 MethodTypeProvidersFee
💳 Credit/Debit CardsPay In
Visa MasterCard Amex Diners
2.99% + 0.18 USD
🏦 Bank TransferPay InSPEI1% + 0.5 USD
💸 APMsCash In
OXXO Pay Walmart Kiosco Bodega Aurrera 7-Eleven
3.5% + 0.75 USD