Payment Providers: Default Referenced payment methods

Setting up a Default Referenced payment method

Betterez includes a payment method provider called Referenced Payments. In particular, Betterez allows for configuration of different default referenced payment methods or entirely custom ones:

1. Pay Me Later
2. Pay Near Me
3. IVR
4. Pinpad

In all cases, the general mechanic behind each payment type involves interaction with an external service where a unique reference number is obtained. These payment types are asynchronous as it is the extermal system who will update the status of the payment before processing the reservation based on the unique reference number.

There are 3 status that can be returned by the external service:

1. Success indicates that the payment was processed successfully and the transaction will show as Paid
2. Error indicates that there was an error processing the payment and the transaction will remain as Waiting for payment.
3. Pending indicates that the payment has not been processed by the external service and the transaction will show as Waiting for payment.

NOTE: The transaction will not wait forever but rather, once the configured maxWaitTime is reached then the transaction will be set with the status Payment expired

For more specific information on how to configure and use these payment methods, click the links above.

In order to configure the payment types, you will have to navigate to Admin -> Payments in order to continue with the configuration. You can see the payment types in the screenshot below. For assistance in using these payment types, please contact support@betterez.com.

Custom Referenced Payments

Alternatively, you can create a custom referenced payment. This is usually meant for custom integrations or uses different to the 4 default ones. For more detailed instructions on how to configure these, please go to the New Referenced Payment article

Common configurations

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.

Pay manually

You can also use referenced payments without having to do a full integration with an external endpoint.

To do this, leave the API configuration section blank or fill with "TEST" accordingly.

This is useful when your payment provider does not provide a full integration with Betterez.

Paying a transaction with this manual referenced payment will work in a similar way than a regular one. The reference number will be internally generated by Betterez, and the authcode can be entered by the agent.

You will just need to click on the "Pay Manually" button to complete the payment.

Troubleshooting and considerations

• Referenced payments cannot be combined with other payments when the "Wait for payment completion" option is enabled. In this case, a transaction must be paid in full with a single referenced payment.
• Referenced payments cannot be canceled while in "waiting for payment" status. They must be paid first.
• When there is more than 1 payment with referenced payments in a single transaction, the "pay manually" button will record the payment for the first payment of the list.