Skip to content

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.

TabWhat you do there
Payment GatewayChoose the gateway and enter its details
Pair Card TerminalPair this POS with the card terminal

Open the Payment Gateway tab ​

  1. Tap Settings in the left drawer.
  2. 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 tabDetail
How changes are savedSave bar - Discard and Save changes. The button reads Save and activate when you pick a different gateway
Applies toEvery terminal at this outlet
Status at the topThe active gateway, such as Tyro active, or No gateway active

Choose your gateway ​

  1. Tap Settings, then tap Payment Gateway.
  2. Tap the card for your gateway under Gateway.
  3. Fill in the gateway's settings, when it has any.
  4. 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 ​

GatewaySettings on the Payment Gateway tabReprint receipt
TyroMerchant ID, Integrated receipt, Integrated surchargeNo
LinklyNoneYes
Till PaymentsMerchant IDYes
SmartPayNoneNo
mx51NoneNo
ANZNoneNo
AdyenMerchant IDNo

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 ​

SettingWhat it doesOptionsDefault
Gateway cardsPicks the provider your card terminal uses. The POS sends every card payment to the active gateway.The gateways enabled for your accountNone selected

Each card shows one badge.

BadgeWhat it means
ActiveThe gateway the POS uses for card payments now
ConfiguredThe gateway was saved before, but it is not the active one
Not set upThe 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.

SettingWhat it doesOptionsDefault
Merchant IDIdentifies 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_CAEmpty
Integrated receiptTyro 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, OffOff
Integrated surchargeTyro 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, OffOff

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.

  1. Tap Settings, then tap Pair Card Terminal.
  2. Enter the details the pairing screen asks for.
  3. Tap the pair button.
  4. 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.

GatewayWhat the pairing screen asks forPair button
LinklyUsername, Password, Pairing codePair device
TyroMerchant ID, Terminal IDPair terminal
SmartPayPairing codePair terminal
Till PaymentsMerchant ID, Terminal. Tap Refresh terminals to reload the terminal listPair device
AdyenPOS ID, Sale ID, TerminalPair device
mx51Follow the prompts on screen-
ANZFollow 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.

  1. Tap Settings, then tap Payment Gateway.
  2. Tap Reprint receipt under Logs and receipts.
  3. Enter the transaction number.
  4. Tap Re-print Receipt.
GatewayFieldRule
LinklyTxn NumberThe transaction number of the payment
Till PaymentsTransaction IdRequired. It must be a complete, valid transaction ID

To reprint the POS receipt for an order, see Receipts & Refunds.

The card terminal's own receipt is controlled on the General tab.

  1. Tap Settings, then tap General.
  2. Find EFTPOS card receipt under Receipts.
  3. Toggle it on.

The change saves instantly. See General settings.

Messages you may see ​

MessageWhat 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 availableNo 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 IdThe 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 ​

Pratham POS User Guide