Payment Gateways
This page covers how to configure a payment terminal gateway so the POS can send card payment requests to your EFTPOS terminal.
Overview
Pratham ResPOS integrates with the following payment gateway providers:
| Gateway | Common Use |
|---|---|
| Linkly | Most common in Australia (PC-EFTPOS) |
| Tyro | Tyro EFTPOS terminals |
| SmartConnect | SmartPay terminals |
| Till Payment | Till Payments in-store terminals |
| MX51 | MX51 SPI-compatible terminals |
| ANZ | ANZ in-store EFTPOS terminals |
| Adyen | Adyen in-store payment terminals |
Only one gateway can be active at a time. The active gateway is the one the POS sends all card payment requests to.
Navigate to POS Settings → Payment Gateway to configure.
Image: Screenshot of the Payment Gateway settings screen
General Configuration
Regardless of which gateway you use, the following applies:
| Setting | Description |
|---|---|
| Active Gateway | The payment gateway currently in use at this terminal |
| Integrated Surcharge | Whether the surcharge is calculated and applied by the gateway (rather than the POS) |
| Integrated Receipt | Whether the EFTPOS receipt is printed by the terminal (rather than the POS printer) |
Linkly
Linkly (formerly PC-EFTPOS) is the most widely used payment integration in Australian restaurants.
Requirements
- A Linkly-compatible EFTPOS terminal (e.g., Verifone, Ingenico, PAX)
- Linkly client software installed and running on the local machine or network
- Pairing token provided by your payment provider
Setup Steps
- Navigate to POS Settings → Payment Gateway.
- Select Linkly as the active gateway.
- Enter the connection details provided by your Linkly administrator:
| Field | Description |
|---|---|
| Username | Linkly client username |
| Password | Linkly client password |
| Terminal Address | Local IP or hostname of the machine running the Linkly client |
- Tap Test Connection to verify the connection to the Linkly client.
- Once connected, tap Pair Terminal to link the EFTPOS terminal.
- The terminal will display a pairing prompt — follow the on-screen instructions on the terminal to complete pairing.
Image: Screenshot of the Linkly gateway configuration screen
Testing a Linkly Payment
After pairing, process a $0.01 or $1.00 test transaction to confirm end-to-end connectivity before going live.
Tyro
Tyro terminals connect directly over the network without requiring a separate client application.
Requirements
- A Tyro EFTPOS terminal
- Tyro merchant credentials (provided by Tyro when you sign up)
- The terminal must be on the same network as the POS device
Setup Steps
- Navigate to POS Settings → Payment Gateway.
- Select Tyro as the active gateway.
- Enter your Tyro credentials:
| Field | Description |
|---|---|
| Merchant ID | Your Tyro merchant identifier |
| API Key | Tyro API key for this location |
- Tap Pair Terminal.
- Follow the pairing instructions displayed on the Tyro terminal.
Image: Screenshot of the Tyro gateway configuration screen
SmartConnect
SmartConnect is used with SmartPay EFTPOS terminals.
Requirements
- A SmartPay terminal configured with SmartConnect
- Merchant account details from SmartPay
Setup Steps
- Navigate to POS Settings → Payment Gateway.
- Select SmartConnect as the active gateway.
- Enter the connection details provided by SmartPay:
| Field | Description |
|---|---|
| Merchant ID | Your SmartPay merchant ID |
| Account ID | Your SmartPay account ID |
- Tap Test Connection to verify.
- Follow any terminal pairing prompts on the device.
Image: Screenshot of the SmartConnect gateway configuration screen
Surcharge Configuration
If your business charges a surcharge for card payments, it can be handled in two ways:
| Mode | Description |
|---|---|
| POS-managed surcharge | The POS calculates and adds the surcharge to the transaction total before sending to the terminal |
| Integrated surcharge | The gateway/terminal calculates and applies the surcharge itself |
Configure this via the Integrated Surcharge toggle in POS Settings → Payment Gateway.
Check with your payment provider which mode your terminal supports. Most modern setups use integrated surcharge.
Troubleshooting
| Issue | Steps |
|---|---|
| Terminal not responding | Check the terminal is powered on and connected to the network |
| Test connection fails | Restart the terminal and the Linkly client (if applicable); recheck IP address and credentials |
| Transaction declined | Ask the customer to try a different card; check the terminal display for an error code |
| Terminal shows "Unpaired" | Repeat the pairing process in POS Settings → Payment Gateway |
| Duplicate transaction concern | Do not process another payment — check Order History and contact your gateway provider before any refund |
For more, see Troubleshooting.