DocumentationAPI Reference
Documentation

About

Oxxo Logo

OXXO is a chain of convenient stores that offers alternative cash payments in Mexico. After choosing the OXXO payment method at an online marketplace, shoppers are able to pay at their local OXXO store.

OXXO commands significant market share in Mexico with over a third of online payments performed on the network.

Payment Flow

688

Here's an example of what Oxxo might look like online:

387

Here's one example of how one merchant, Nippon-Yasan, has integrated OXXO in their checkout process:

*we always recommend using the the correct RFC for your shopper

Properties

Type of Payment
Offline
Chargebacks
Yes. There is a risk of chargeback to merchants, as payment is not guaranteed and a dispute process is available to shoppers.
Consumer Currency
MXN
Consumer Country
Mexico
Expiry Period
The OXXO voucher states that it is no longer valid after 3 business days.
Recurring Payments
Yes
Partial Payment
No. The shopper must pay the entire amount due on the OXXO voucher.
Refunds
This payment method has a refund period of 180 days.

FAQ

  • Consumer information in Mexico must include either the RFC, or CURP, or IFE in the "NationalIdentifier" field.
  • The maximum transaction amount for OXXO in Mexico is MXN 10.000

Best Practices

  • See Shopper Journey
  • Because shoppers have the option to pay the OXXO voucher at a physical store, there is often a lag of multiple days between the order being placed and the order being paid. Remember to wait until payment is made to ship any physical goods.
  • If you cancel an order, it's best that you reach out to the customer immediately and let them know. If you cancel an OXXO order while it's pending, the customer will have no way of knowing that the order was canceled. As such, they may pay that slip and wait for the order to arrive, but it never will.
  • Once the customer is able to see the OXXO ticket, then there is no way to cancel the order.

Technical Considerations

  • Because shoppers have the option to pay the OXXO voucher at a physical store, there is often a lag of multiple days between the order being placed and the order being paid. Remember to wait until payment is made to ship any physical goods.
  • "Authorize" and "Capture" aren't really relevant to the OXXO payment process. OXXOs can't be "Cancelled," either. They can either be paid or not paid.
  • In this way, it is possible to cancel an offline order only if the shopper has not yet redirected through the Reach system to see the ticket. Once the customer sees the ticket, there is no way to cancel the order, as the customer may pay the voucher at any time.
  • As part of the consumer information, you may include either the RFC, or CURP, or IFE in the "NationalIdentifier" field.
  • Mexican addresses must include a ZIP code, and use the abbreviation code for the state below:
CodeNameCodeName
AGSAguascalientesMORMorelos
BCBaja CaliforniaNAYNayarit
BCSBaja California SurNLNuevo Leon
CAMCampecheOAXOaxaca
COACoahuilaPEUPuebla
COLColimaQROQueretaro
CHSChiapasROOQuintana Roo
CHIChihuahuaSLPSan Luis Potosi
DFDistrito FederalSINSinaloa
DGODurangoSONSonora
GTOGuanajuatoTABTabasco
GROGuerreroTAMTamaulipas
HGOHidalgoTLATlaxcala
JALJaliscoVERVeracruz
MEXMexicoYUCYucatan
MICMichoacanZACZacatecas
{
  "MerchantId": "e78e8cd0-24b8-4b0c-a922-87a1d8cc61c3",
  "ReferenceId": "1540602856312",
  "PaymentMethod": "OXXO",
  "ConsumerCurrency": "MXN",
  "Capture": true,
  "Items": [
    {
      "Description": "Piston Ring",
      "ConsumerPrice": 100,
      "Quantity": 1,
      "Sku": "4383471583721"
    }
  ],
  "Consumer": {
    "Name": "Jane Doe",
    "Email": "[email protected]",
    "Phone": "1234567890",
    "Address": "123 Any Street",
    "City": "Somewhere",
    "Region": "14",
    "PostalCode": "12345",
    "Country": "MX",
    "NationalIdentifier": "00003456790"
  },
  "DeviceFingerprint": "a5772185-1c9a-4646-9772-557fc6083ea2",
  "Return": "https://checkout-sandbox.gointerpay.net/return.php"
}
{
  "OrderId": "b5a210dd-7465-459f-93fb-032712def3fe",
  "UnderReview": false,
  "Expiry": "2018-11-07T01:13:22Z",
  "Authorized": false,
  "Completed": false,
  "Captured": false,
  "Action": {
    "Redirect": "https://sandbox.gointerpay.net/auth/52ee3ba0-4d76-47f9-8634-435644514755"
  }
}

Testing

  • Because OXXO is an offline payment method, testing is a manual process. As you put through test transactions in Sandbox, just contact support when you're ready for instructions on how to manually advance the transaction to your desired stage.
  • To test expiration, contact the Reach support team, and we can manually expire the order.

Related Information

API icon

Please see our most recent API guide.