Payment Gateways
What it does
A payment gateway connects the POS to your card terminal. Once it is set up, the POS sends each card payment to the terminal, and the terminal does the rest.
Setup has two parts, on two tabs.
| Tab | What you do there |
|---|---|
| Payment Gateway | Choose the gateway and enter its details |
| Pair Card Terminal | Pair this POS with the card terminal |
Open the Payment Gateway tab
- Tap Settings in the left drawer.
- Tap Payment Gateway.
INFO
🔒 Manager only - the Settings item shows only for staff whose role has permission to see it. Roles are set up in the Admin portal.
| About this tab | Detail |
|---|---|
| How changes are saved | Save bar - Discard and Save changes. The button reads Save and activate when you pick a different gateway |
| Applies to | Every terminal at this outlet |
| Status at the top | The active gateway, such as Tyro active, or No gateway active |
Choose your gateway
- Tap Settings, then tap Payment Gateway.
- Tap the card for your gateway under Gateway.
- Fill in the gateway's settings, when it has any.
- Tap Save and activate.
Only one gateway is active at a time. Saving a different gateway makes it the active one.
Gateways and what each one needs
| Gateway | Settings on the Payment Gateway tab | Reprint receipt |
|---|---|---|
| Tyro | Merchant ID, Integrated receipt, Integrated surcharge | No |
| Linkly | None | Yes |
| Till Payments | Merchant ID | Yes |
| SmartPay | None | No |
| mx51 | None | No |
| ANZ | None | No |
| Adyen | Merchant ID | No |
Choose the gateway that matches your card terminal provider. Ask your provider when you are unsure.
INFO
The gateways listed on this tab are the ones enabled for your account. With none enabled, the tab shows No gateways available. Contact support to have a gateway enabled.
Gateway
| Setting | What it does | Options | Default |
|---|---|---|---|
| Gateway cards | Picks the provider your card terminal uses. The POS sends every card payment to the active gateway. | The gateways enabled for your account | None selected |
Each card shows one badge.
| Badge | What it means |
|---|---|
| Active | The gateway the POS uses for card payments now |
| Configured | The gateway was saved before, but it is not the active one |
| Not set up | The gateway has never been saved for this outlet |
Gateway settings
This section takes the gateway's name, such as Tyro settings. It is hidden for Linkly, SmartPay, mx51 and ANZ, which have no settings here.
| Setting | What it does | Options | Default |
|---|---|---|---|
| Merchant ID | Identifies your merchant account to the gateway. Your provider gives it to you. Shown for Tyro, Till Payments and Adyen. Required. | Tyro and Till Payments: text. Adyen: a dropdown with PrathamPOS_AU, PrathamPos_US, PrathamPos_CA | Empty |
| Integrated receipt | Tyro only. On: Tyro passes the merchant card receipt to the POS. The POS prints it on the bill printer when EFTPOS card receipt is on in Settings → General → Receipts. Off: the POS does not print Tyro's merchant card receipt for a purchase. | On, Off | Off |
| Integrated surcharge | Tyro only. On: the POS asks the Tyro terminal to add its card surcharge to the payment. The surcharge the terminal charged is recorded on the payment. | On, Off | Off |
TIP
Ask Tyro which receipt and surcharge setup your terminal uses before you change Integrated receipt or Integrated surcharge.
Pair the card terminal
Pair the terminal after you save and activate the gateway.
- Tap Settings, then tap Pair Card Terminal.
- Enter the details the pairing screen asks for.
- Tap the pair button.
- Follow the prompts on the POS and on the card terminal.
You can also open the same screen from Operations. Tap Operations, then tap Pair Gateway.
The pairing screen is different for each gateway. It always shows the screen for the active gateway.
| Gateway | What the pairing screen asks for | Pair button |
|---|---|---|
| Linkly | Username, Password, Pairing code | Pair device |
| Tyro | Merchant ID, Terminal ID | Pair terminal |
| SmartPay | Pairing code | Pair terminal |
| Till Payments | Merchant ID, Terminal. Tap Refresh terminals to reload the terminal list | Pair device |
| Adyen | POS ID, Sale ID, Terminal | Pair device |
| mx51 | Follow the prompts on screen | - |
| ANZ | Follow the prompts on screen | - |
The on-screen prompts guide the rest of the pairing. Your provider supplies the usernames, pairing codes and IDs.
INFO
Linkly pairing is saved against this POS terminal. Pair each POS terminal that takes Linkly payments.
Reprint a card receipt
Reprint is available for Linkly and Till Payments.
- Tap Settings, then tap Payment Gateway.
- Tap Reprint receipt under Logs and receipts.
- Enter the transaction number.
- Tap Re-print Receipt.
| Gateway | Field | Rule |
|---|---|---|
| Linkly | Txn Number | The transaction number of the payment |
| Till Payments | Transaction Id | Required. It must be a complete, valid transaction ID |
To reprint the POS receipt for an order, see Receipts & Refunds.
Print the card receipt with every card payment
The card terminal's own receipt is controlled on the General tab.
- Tap Settings, then tap General.
- Find EFTPOS card receipt under Receipts.
- Toggle it on.
The change saves instantly. See General settings.
Messages you may see
| Message | What it means / what to do |
|---|---|
| Choose a gateway to get started. | No gateway is selected. Tap a gateway card. |
| Saving makes [gateway] the active gateway. | You picked a different gateway. Tap Save and activate to switch. |
| Gateway saved and activated. | The gateway is saved and is now the active one. |
| Gateway settings saved. | Your changes to the active gateway are saved. |
| Failed to save gateway settings. | The save did not go through. Check the internet connection and try again. |
| Failed to load payment gateways. | The tab could not load the gateway list. Check the internet connection and open the tab again. |
| Merchant ID is required. | Merchant ID is empty. Enter or select it. |
| No gateways available | No gateway is enabled for your account. Contact support. |
| Setup Payment gateway from settings and then proceed! | You tapped Pay but no gateway has been saved for this outlet. Save a gateway on the Payment Gateway tab. |
| Please setup payment gateway for payments. | You started a card payment but no gateway is active. Activate a gateway. |
| A card payment is already in progress. Please wait for it to finish. | The terminal is still busy with the last card payment. Wait for it to finish. |
| Invalid Transaction Id | The Till Payments transaction ID is not in the right format. Check it and enter it again. |
FAQs
Staff tap Pay and see "Setup Payment gateway from settings and then proceed!" - why?
No payment gateway has been saved for this outlet. Open Settings → Payment Gateway, tap your gateway and tap Save and activate.
Why is there no settings section for my gateway?
Linkly, SmartPay, mx51 and ANZ have no settings on the Payment Gateway tab. Tap the gateway card, tap Save and activate, then pair the terminal on the Pair Card Terminal tab.
Where are Integrated receipt and Integrated surcharge?
They show for Tyro only. Tap the Tyro card to see them.
Where do I enter my Linkly username and password?
On the pairing screen. Tap Settings, then tap Pair Card Terminal. The Payment Gateway tab has no fields for Linkly.
I switched gateway. Do I need to pair again?
Yes. The Pair Card Terminal tab shows the pairing screen for the active gateway. Pair the terminal for the new gateway.
Does the gateway choice apply to all my terminals?
Yes. The active gateway and its settings apply to every terminal at this outlet.
The card terminal does not respond. What should I check?
Check the terminal is switched on and connected to the network. Then pair it again on the Pair Card Terminal tab.
I am worried a customer was charged twice. What should I do?
Do not take another payment. Check the order in Orders, or in Operations → Receipts & Refunds, to see which payments were recorded. Contact your gateway provider before you refund anything.
Next steps
- Settings - Payment Methods - choose which payment methods show at checkout
- Surcharges - how surcharges work on an order
- Payments - taking a payment
- Troubleshooting - more help with card payments
