Payment Providers: Referenced payment, Pinpad method

Setting up a Referenced payment, Pinpad method

In order to configure the Pinpad referenced payment method, navigate to Admin -> Payments and selected the pinpad payment method.

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.

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.

Changeable If checked, tickets purchased with this method of payment will be 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.

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:

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:

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

External Type Is the id used by the payment provider for this payment type

API URL Is the URL of the referenced payment provider. For testing enter "."

API Token Is provided by the referenced payement provider. For testing can be any text.

Refund Api Url Is the URL of the referenced payment provider used for refunds. For testing enter '.',

Api Token Refund Url Is provided by the referenced payment refunds provider. For testing can be any text.

Capture credit card info The credit card info will be required and sent to the referenced payment provider on the reference number creation.

Wait for payment completion Indicates whether Betterez waits for the payment provider to complete the payment or marks the transaction with Waiting For Payment status. **NOTE: This referenced payment type will need to conclude while the customer is still on the phone and the **Wait for payment completion** checkbox comes checked by default. While waiting for the payment to complete, a progress meter showing the transactions progress will appear.

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.

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.

NOTE: Negative values have not effects.

Expiration time: This value is sent to facilitate the expiry of the payment by the payment provider during the reference number creation (in case the number created for a product does not have an expiration date). If "Maximum waiting time" is 12 hours and "Expiration Time" is 10 hours, the provider will expire the payment in 10 hours and Betterez will expire it in 12 hours.

Trip departure time offset: This value apply when the sale is made near of the trip departure time and override partially maximum waiting time behaviour.
If the sale is made between trip departure minus this offset, the expiration time will be set from that moment plus the offset. This feature set a time window where the system extends the expiration time beyond the trip departure. Also, it allow made sales after trip departure.
The next image shows two sales made within of time window.

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

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

Click Save to save your configuration settings.