Payment gateway in Mexico: how to accept SPEI, OXXO and cash in your online store
How Mexicans pay online, how SPEI transfers and OXXO cash payments work through a payment gateway, the risks to watch and a checklist for choosing a provider.
6 min read
Also available in: Español
Mexico is one of the largest online markets in Latin America, but getting paid there is not like Europe or the United States. Many buyers have no credit card or prefer not to use it online, and a large share still pays in cash. A store that only takes cards loses sales every day.
This guide explains how Mexicans pay online, how SPEI and OXXO cash payments work through a payment gateway, which risks to watch and how to choose a provider.
How Mexicans pay online
Three main ways to pay online live side by side in Mexico:
| Method | How it works | For whom |
|---|---|---|
| SPEI | Instant bank transfer from the customer's banking app | Customers with a bank account |
| OXXO and cash | The customer gets a reference and pays cash at a store | Customers without an account, or who prefer cash |
| Cards | Debit or credit at checkout | Card holders who use them online |
According to industry reports, cash still carries more weight in Mexico than in many other countries in the region, while instant transfers and digital wallets grow every year. For an online business the message is clear: offer SPEI and cash next to cards.
What is SPEI?
SPEI (Sistema de Pagos Electrónicos Interbancarios) is the transfer system of Banco de México. It moves money between banks in seconds, at any time. Every account has a CLABE, an 18-digit account key.
To take SPEI payments online, a gateway usually gives each order its own CLABE or unique reference. When money arrives at that reference, the gateway knows exactly which order was paid and tells your system by webhook — no checking bank statements by hand.
How OXXO cash payments work
OXXO is the most widespread convenience-store chain in the country. The usual flow:
- At your checkout, the customer chooses pay in cash.
- The gateway creates a payment reference (often with a barcode) with the amount and an expiry date.
- The customer goes to a store, shows the reference and pays in cash.
- The network confirms the payment to the gateway, which sends a webhook to your server.
- Your system marks the order paid and delivers.
Two differences from SPEI matter: the customer may take hours or days to go and pay, and confirmation is not always instant. Cash references therefore usually stay valid longer, and your system should hold the order meanwhile.
How a payment gateway works in Mexico
| Step | What happens | Who does it |
|---|---|---|
| 1. Create the charge | Your site asks the gateway for a charge for the order amount and chosen method | Your server, via API |
| 2. Show instructions | The gateway returns the SPEI reference or the cash payment reference | Gateway → your checkout |
| 3. Customer pays | Transfers from their bank or pays at the store | Customer |
| 4. Confirmation | The network confirms the payment to the gateway | Bank / store → gateway |
| 5. Webhook | The gateway sends a signed webhook: the order is paid | Gateway → your server |
| 6. Fulfilment | Your system marks the order and delivers | Your server |
| 7. Settlement | Funds become available to withdraw | Gateway → your account |
Risks and how to handle them
Fake receipts. Edited screenshots of transfers or store tickets. Rule: never deliver on a screenshot, only when the webhook confirms the payment.
Different amounts. With manual transfers customers can send another amount. A unique reference per order solves almost all of this.
Expired references. A customer pays cash after the expiry. Ask your provider what happens then, and show the deadline clearly.
Missed webhooks. If your server is down, you can miss a confirmation. Use a gateway that retries webhooks and lets you check status by API, and process each webhook idempotently.
For gaming, trading and digital goods
- Gaming and top-ups: credit the balance as soon as the SPEI webhook arrives; for cash, as soon as the store payment is confirmed.
- Trading platforms: take deposits in MXN with a clear record of every payment.
- Digital goods: deliver codes and subscriptions instantly after confirmation.
Checklist for choosing a gateway in Mexico
- SPEI with a unique reference per order.
- Cash payments at stores, with a configurable validity.
- Signed webhooks with retries, and an API to check status.
- A sandbox to simulate paid, failed and expired payments.
- Clear fees, nothing charged on failed payments.
- Settlement that suits you: local account, foreign account or stablecoins.
- Reports with gross, fee and net for each payment.
- One API for several countries, if Mexico is not your only market.
Step by step
- Create a merchant account and add your website.
- Create a sandbox API key and keep it on your server only.
- Set your webhook URL and save the secret.
- At checkout, create the charge by API with the amount and your own order reference.
- Show the SPEI or cash reference with the amount and the deadline.
- Verify the signature of every webhook and mark the order paid only once.
- Test every outcome in the sandbox, then switch to a live key.
How PAYWISE handles Mexico
PAYWISE is an API-first payment platform. Indonesia (QRIS) and crypto payments are live today, and Mexico (SPEI, OXXO and cash) opens on request: merchants who ask first are prepared first. When Mexico opens for your account, you keep the same API, webhooks and dashboard as in every other country.
See the Mexico page and send a request in two minutes.
Frequently asked questions
What is a CLABE? The standard 18-digit bank key that identifies an account in Mexico, used for SPEI transfers.
How fast is a SPEI payment confirmed? Usually within seconds or a few minutes, at any time.
And an OXXO cash payment? It depends on when the customer goes to the store; confirmation can take longer than a transfer.
Can a customer reverse a SPEI payment? Not like a card chargeback. Refunds are made with a new transfer.
Can a foreign company get paid in Mexico? Yes, through a provider that collects locally and settles to you. Ask how funds are settled and converted.
Sources: Banco de México — SPEI, Nuvei — how consumers in Mexico prefer to pay online in 2026, PayRetailers — cross-border payments in Latin America 2026. This article is general information, not legal or financial advice.

