Skip to main content
OXXO is a cash payment method in Mexico. Customers get a payment voucher for their purchase online, then pay it in cash at an OXXO convenience store. It gives customers who prefer cash, or don’t have a card, a way to pay online. Payrails processes OXXO through dLocal as the payment service provider (PSP).

​
How an OXXO payment works

OXXO is a voucher payment method:
  1. The customer selects OXXO at checkout.
  2. Payrails returns a redirect URL from dLocal, and the customer goes to the dLocal payment page.
  3. The page shows an OXXO voucher with a reference code and a barcode.
  4. The customer pays the amount in cash at an OXXO store with the reference code or the barcode.
  5. Payrails receives the final result from dLocal and updates the payment.
The payment stays pending until the customer pays at the store. Each payment is single-use: every purchase gets its own voucher. Payrails captures OXXO payments immediately, so a successful payment is final. To return funds, refund the payment.

​
Supported currencies and countries

OXXO supports MXN (Mexican peso) as its only presentment currency.

​
Integrate OXXO

Choose the PSP that processes OXXO for you. The guide covers the PSP-side setup, the Payrails configuration and the request fields that PSP requires.

dLocal

OXXO via dLocal

​
Check PSPs

​
Ways to integrate OXXO

  • Payrails SDK: the Web SDK shows OXXO when your workflow returns it as a payment option, and redirects the customer to the dLocal payment page. To control how the redirect opens, listen for the actionRequired event.
  • Payrails API: call lookup payment options, then authorize with oxxo as the paymentMethodCode. The PSP guide lists the meta fields that PSP requires.
In both cases, confirm the final result through webhook notifications or the execution status. A customer who returns to your site hasn’t paid yet, so wait for the result before you ship the order.
Last modified on October 5, 2026