Payment Providers: Oxxo method

Setting up Oxxo payment method

In order to configure the Oxxo payment, navigate to Admin -> Payments and selected the oxxo_pay payment method.

Display options

Once on the Edit payment method screen the user will be required to configure the following fields:

Display Name The name you would like displayed in the shopping cart list of payment methods.

Enabled If checked, this payment method will be available for those sales flow channels it'll be configured.

Sort Order The higher the number, the lower in the list of payment methods this payment method will appear.

Options

Require address on Back end If checked, this payment method will require the address of the customer in the back end sales flow.

Require address on Web sales If checked, this payment method will require the address of the customer in the web sales sales flow.

Refundable and Changeable If checked, tickets purchased with this method of payment will be refundabled or changeable.

Include in the deposit totals If checked, this payment type will have documentation that is necessary to include with seller shift deposit before closing a shift.

Send automatic emails for refund receipts Send automatic emails for refund receipts: Determines whether the receipt should be automatically emailed when refunding with this method. If set to 'Use system default', the behavior will follow the 'Email refund receipts automatically' setting in the account's admin/setup page.

Restrictions

Stations with active payment Determines at which stations this payment method will be available. You can apply the method to all stations or restrict it based on specific selection criteria.

Stations Allows selecting specific stations where this payment method will be enabled. The list of stations will be defined according to the criteria selected above.

Combine

If Allow to combine is checked, the payment method can be combined with any other payment method on the payment form. You can also set a list of payments which can't be part of that combination:

Channels

Make sure to select the right channel. If the account is a multi-currency account, at least one currency per enable channel will be required:

This payment method is only available for MXN currency.

Subdomains

If your account has custom subdomains you can also configure the domains this payment method will be available for.

Parameters

You should configure the parameters for the payment method to connect to the external payment provider:

Token It will be autogenerated on payment method creation. Is unique and will be used by Oxxo to identify the account.

Time based parameters

The next configuration set the expiration time of referenced payments.

By default, and if these parameters are not set, a payment will expire at trip departure time and if it has not a trip departure time the payment will expire after 12 hours.

Sale using this kind of providers after trip departure time could have an unexpected behaviour. If you need sale after trip departure please consider set a maximum waiting time.

Cutt off time: Indicates how much time before the trip date is needed to have this payment method available. It should be major than 'Maximum waiting time' and 'Trip departure time offset' to avoid errors related to expiration times

Maximum waiting time: Indicates the time Betterez will wait for the payment to be processed. After that time the referenced payment will expire. If the calculed expiration time exceeds the trip departure, then the payment will expire in the trip departure time.

If the sale time exceeds trip departure time, then the payment will expire from that moment plus maximum waiting time.

This parameter override the default behaviour.

The image below show three differents scenarios: before the trip departure time, near trip departure time and after trip departure time.

Negative values have not effects.

Expiration time: Will be sent to the referenced payment provider on the reference number creation, in case the number created for a product does not have an expiration date.

This field is sent to facilitate the expiry of the payment by the referenced payment provider.

If MaxWaitTime is 12 hours and ExpirationTime is 10 hours. The referenced payment provider will expire the payment in 10 hours and Betterez will expire it in 12 hours

Trip departure time offset: Signed offset (after your unit is converted to seconds). Use a positive value to expire referenced payments before the first trip departure (for example, 15 minutes before departure).

Use a negative value to allow the payment window to extend after departure, still limited by Max wait time. Leave at zero to use the default departure-based timing without this offset.

This option only works if "Maximum waiting time" has been set. Negative values have not effects.

Click Save to save your configuration settings.