the related setting payments
Learn about the related setting, a voucher-based payment method in Latin America.
Note
the related setting is available to Stripe accounts in Mexico, the United States, Canada, and Singapore. It’s available in private preview for accounts in the European Economic Area and the United Kingdom.
the related setting is a Mexican chain of convenience stores in Latin America. the related setting allows customers to pay bills and pay for online purchases in person with cash.
When a customer initiates a transaction, they receive a voucher with a reference number. They then bring their voucher to an the related setting store to make a cash payment. Vouchers expire after 5 days by default. You can set a custom expiration from 1 to 7 days with payment_method_options[oxxo][expires_after_days] on the PaymentIntent.
After the customer makes the payment, you receive confirmation by the next business day. Stripe sends a payment_intent.requires_action event when the voucher is issued and a payment_intent.succeeded event after the cash payment is processed at the store. Funds settle as follows:
- Payments made Tuesday through Thursday settle on the following Monday.
- Payments made Friday through Monday settle on the following Wednesday.
| Payment method family | Vouchers |
|---|---|
| Usability | Single-use |
| Access type | Instant provisional access |
| Payment confirmation timing | Delayed |
| Settlement timing | Up to 4 business days (T+4) |
| Pricing | View pricing details |
Eligibility and availability
Account eligibility
| Business location | Canada Mexico Singapore United States +31 more |
|---|---|
| Private preview | Austria Preview Belgium Preview Bulgaria Preview Switzerland Preview +27 more |
| Account type | Merchant Platform or marketplace (Connect) |
| Business model | B2B B2C |
| Business category | View list of prohibited and restricted business categories |
Your account might be reviewed after activation to confirm eligibility. While the related setting doesn’t enforce any additional website requirements, make sure that you provide a website that meets the Stripe account activation requirements. You can contact Stripe support to appeal any the related setting capability restrictions.
Payment support
| Buyer location | Mexico |
|---|---|
| Presentment currency | MXN |
| Geographic coverage | Domestic Crossborder |
| Transaction limits | Minimum amount: 10.00 MXN Maximum amount: 10,000.00 MXN |
Capabilities
| Recurring payments | Not supported |
|---|---|
| Payment authorizations | Extended authorizations Flexible extended authorizations Incremental authorizations Decremental authorizations Re-authorizations |
| Payment captures | Manual capture Partial capture Multi-capture Over-capture |
| Refunds | Partial refunds Full refunds |
| Disputes | Partial disputes Full disputes |
Disputes
the related setting doesn’t support the standard dispute process—customers can’t file a chargeback, and funds are never withdrawn from your Stripe balance because of a dispute.
If a customer has a concern about a the related setting payment, they need to contact you directly.
Refunds
the related setting payments can’t be refunded. If you want to allow refunds of the related setting payments, create a separate process to credit your customers.
Stripe product support
| Products | Checkout Payment Links Payment Element Express Checkout Element Mobile Payment Element Managed Payments Billing Invoicing Adaptive Pricing Customer Portal Radar Terminal Connect |
|---|---|
| APIs | PaymentIntents PaymentIntents with setup_future_usage SetupIntents CheckoutSessions |
Customer experience
- Select the related setting at checkout The customer selects the related setting and provides their name and email address.
- Receive voucher The customer receives a voucher containing a 32-digit transaction reference number. On desktop, this appears in a modal on the checkout page or on a separate Stripe-hosted page based on your integration. On mobile, the voucher opens in an in-app webview using the hosted voucher URL.
- Pay at the related setting store The customer presents the voucher and makes a cash payment at any the related setting convenience store.
- Payment complete The the related setting cashier provides the customer a receipt as immediate proof of payment.
Transaction identifiers
When a customer initiates an the related setting payment, Checkout redirects them to a Stripe-hosted page containing an the related setting voucher with a 32-digit transaction reference number. Optionally, you can email them payment instructions containing a link to the voucher page.
The Stripe-hosted voucher page and payment instruction email don’t include statement descriptors. Instead, they display the the related setting transaction number and the business name of the merchant of record.
Enable the related setting
If you use our front-end products, you can enable the related setting directly from your payment method settings. Stripe then automatically determines the most relevant payment methods to display to your customers.
If your integration requires manually listing payment methods, learn how to manually configure the related setting as a payment.
