Accept an OXXO payment

A Checkout Session must satisfy all of the following conditions to support OXXO payments:

• Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.
• You can only use one-time line items (recurring subscription plans are not supported).

Use this guide to learn how to enable OXXO—it shows the differences between accepting a card payment and using OXXO.

Enable OXXO as a payment method

When creating a new Checkout Session, you need to:

1. Add oxxo to the list of payment_method_types
2. Make sure all your line_items use the mxn currency.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'oxxo'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    oxxo: {
      expires_after_days: 2
    }
  },
  line_items: [{
    price_data: {
      # To accept `oxxo`, all line items must have currency: mxn
      currency: 'mxn',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Additional payment method options

You can specify an optional expires_after_days parameter in the payment method options for your Session that sets the number of calendar days before an OXXO voucher expires. For example, if you create an OXXO voucher on Monday and you set expires_after_days to 2, the OXXO voucher will expire on Wednesday at 23:59 America/Mexico_City (UTC-6) time. The expires_after_days parameter can be set from 1 to 7 days. The default is 3 days.

Redirect to Stripe hosted voucher page

After submitting the Checkout form successfully, the customer is redirected to the hosted_voucher_url. The customer can find the barcode or print the OXXO voucher from the hosted voucher page. You can locate the hosted_voucher_url in payment_intent.next_action.oxxo_display_details.

Stripe allows customization of customer-facing UIs on the Branding Settings page. The following brand settings can be applied to the voucher:

• Icon—your brand image and public business name
• Accent color—used as the color of Print button
• Brand color—used as the background color

Fulfill your orders

Because OXXO is a delayed notification payment method, you need to use a method such as webhooks to monitor the payment status and handle order fulfillment. Learn more about setting up webhooks and fulfilling orders.

The following events are sent when the payment status changes:

When testing your Checkout integration, select OXXO as the payment method and click the Pay button.