How to Set Up Linkly EFTPOS in Odoo POS

EFTPOS integration is essential for Australian retailers using Odoo POS. Without it, staff manually key the transaction amount into the payment terminal for every sale — slow, error-prone, and frustrating. Our Linkly EFTPOS module connects Odoo POS directly to your payment terminal so the amount flows automatically.

What you need

• Odoo Enterprise with the POS module installed.
• A Linkly-compatible EFTPOS terminal — Most Ingenico, Verifone, and PAX terminals used in Australia are Linkly-compatible. Check with your payment terminal provider.
• A Linkly cloud account — Contact your terminal provider or Linkly directly to set up cloud API access.
• Our Linkly EFTPOS module — Available from our apps page.

Step 1: Install the module

• Download the Linkly EFTPOS module from our apps page.
• Install it on your Odoo instance (Odoo.sh or self-hosted — not available on Odoo Online due to custom module restrictions).
• Go to Apps, update the app list, and install "Linkly EFTPOS Integration."

Step 2: Configure the Linkly connection

• Go to Point of Sale → Configuration → Payment Methods.
• Create a new payment method or edit an existing card payment method.
• Set the Payment Terminal type to "Linkly."
• Enter your Linkly credentials — the API key and secret provided by Linkly.
• Enter the Terminal ID (Pinpad ID) — this identifies which physical terminal to send transactions to.
• Set the merchant code if required by your payment processor.
• Click Save.

Step 3: Assign to POS config

• Go to Point of Sale → Configuration → Point of Sale (your POS settings).
• Under Payment Methods, add the Linkly payment method.
• If you have multiple stores/registers, configure a separate payment method per terminal (each with its own Terminal ID).
• Save the POS configuration.

Step 4: Test the connection

• Open a POS session.
• Create a test sale.
• Select the Linkly card payment method.
• The transaction amount should appear on the EFTPOS terminal automatically.
• Complete the transaction with a test card (tap, insert, or swipe).
• The payment result (approved/declined) returns to Odoo POS automatically.
• The POS receipt should show the card payment details.

Supported payment types

• Tap-and-go — Contactless payments (Visa payWave, Mastercard Contactless, American Express).
• Chip and PIN — Insert card and enter PIN.
• Mobile wallets — Apple Pay, Google Pay, Samsung Pay — all work via the Linkly terminal.
• Split payments — Split a sale between card and cash, or between multiple cards.
• Refunds — Process refunds through Odoo POS. The refund amount is sent to the terminal for card refund processing.

Multi-terminal setup

• For multi-register stores, create a separate Linkly payment method for each physical terminal.
• Each payment method has its own Terminal ID pointing to the specific EFTPOS device.
• Assign the correct payment method to each POS configuration (register).
• This ensures each register talks to its own terminal — no cross-talk between registers.

Reconciliation

• At the end of each POS session, Odoo records all card payments with transaction references.
• These payments reconcile against your bank settlements.
• The settlement amount from your payment processor should match the total card payments recorded in Odoo for that day.
• Any discrepancies are flagged during POS session closing.

Troubleshooting

• Terminal not responding — Check that the terminal is powered on, connected to the internet, and the Terminal ID in Odoo matches the physical device.
• Transaction timeout — Linkly cloud transactions require stable internet. If your store has unreliable internet, consider a wired connection for the POS terminal.
• Amount mismatch — Ensure GST-inclusive pricing is configured correctly in Odoo POS. The amount sent to the terminal must match what the customer sees.

For detailed documentation on our Linkly EFTPOS module, see how it works. If you need help with setup, contact us.