EFTPOS transactions

Four EFTPOS transaction types are supported on machines:

• Purchases
• Refunds
• Reporting
• Reconciliation and Settlement

However, the Transaction SDK currently only supports integrated Purchase transactions with associated response data. Other functions can be accessed directly on the machine or via the Tyro Health provider web portal.

For all transactions

To process EFTPOS transactions, set:

• The platform attribute to funder

EFTPOS transactions are run under a merchant identifier or MID which controls:

• The name of the business as presented on cardholder statements
• Settlement bank details - directing payments for approved transactions
• Invoicing from Tyro for any EFTPOS machine rental and merchant service fees

A single EFTPOS machine can support multiple MIDs. This arrangement may be important for healthcare practice locations which support many independent providers but share a single physical EFTPOS machine. These MIDs can be associated with a single business and API key in the context of Tyro Health and dynamically changed at each transaction.

MIDs can be associated with a providerNumber so that a EFTPOS transaction sent with a providerNumber will also set the default MID.

Although multiple payment card processing methods are supported, set payment-method to terminal for EFTPOS machines.

Purchases

The process to complete a EFTPOS purchase transaction is as follows:

Set a chargeAmount in the PMS and send it to SDK, along with other optional details. Cardholders tap, swipe or insert their payment card on the machine. If the card has multiple linked payment types - such as Credit, CHQ, SAV - the cardholder will be presented an option to select one for the transaction. A transaction result is returned in real-time to the PMS and the machine prints a payment receipt.

The chargeAmount is the total amount (note surcharges) to be debited on a payment card. This amount is the aggregated total, including any GST component. Line item details such as items are not required.

Surcharging

Tyro EFTPOS machines support payment processing surcharges to be passed on to the cardholder. The surcharge is to cover merchant service fees and can be dynamically set depending on card type presented, e.g., a Platinum Visa credit card will have higher fees than a Visa debit card.

Surcharging can be optionally enabled on the terminal. However, this setting cannot be configured via the Transaction SDK. When surcharging is enabled, the terminal will dynamically add a surcharge amount to each transaction. This adjusted amount will be paid to the merchant but is not currently returned in the completion message and may result in a reconciliation mis-match or a total that is not aligned with the PMS invoice amount.

Refunds

Integrated refunds are not currently supported via the SDK. Refunds can be issued via the Tyro Health Online portal and actioned on a terminal.

Refunds can be issued for payment transactions at any point as long as the payment card has not expired and the amount is not above the original charge amount. Refunds usually require an administrator PIN to be entered on the terminal prior to completion. This administrator PIN should be known by the business administrator.

Reporting

Integrated reporting is not currently supported via the SDK.

Reconciliation and settlement

End of day reconciliation and settlement reports can be manually generated on the terminal. This is a printed list of transactions processed for the settlement period.