WooCommerce POS Linkly Terminal Connector Help Center

Search the documentation, jump to a task, or browse help topics — everything you need to connect Linkly, pair your tills, and take card payments on the WooCommerce POS.

What Are You Trying to Do?

Set up the plugin for the first time Enter my Linkly credentials Test with the Linkly sandbox Offer Linkly at one outlet only Pair a till with a terminal Take a card payment Retry a declined payment Look up an exact error message

I Need Help As…

A Store Owner Setting Up

Install the connector, add your Linkly credentials, and choose where Linkly is offered.

A Cashier at the Counter

Pair your till with the terminal and take card payments during the day.

Someone Fixing a Problem

Find the cause of a pairing or payment error and the fix.

Browse Help Topics

Getting StartedHow to use this guide and what the plugin covers.OverviewHow the POS, Linkly Cloud, and terminal work together.FeaturesEverything the connector does, by role.InstallationUpload, activate, and what activation creates.Gateway ConfigurationEnable, default gateway, test mode, credentials.POS Payment MethodRename or disable POS Linkly Reader.OutletsChoose which outlets offer Linkly.Terminal PairingPair a till using the terminal pair code.Taking PaymentsPayment flow, invoices, retries, order status.TroubleshootingProblem scenarios plus a full error index.FAQ and NotesQuick answers to the most common questions.

Requirements and Compatibility

Current release: WooCommerce POS Linkly Terminal Connector 1.1.0.

Requirement	Supported
WordPress	6.5 or higher (tested up to 7.1)
WooCommerce	9.1 or higher (tested up to 11.1) — must be installed and active
WooCommerce Point of Sale	6.0 or higher (tested up to 7.2) — must be installed and active
PHP	7.4 or higher (tested up to 8.5)
Linkly	Linkly Cloud account (test and/or live credentials) and a Linkly PIN pad
Network	Your server must be able to reach Linkly Cloud over HTTPS

See the full system requirements and installation steps.

Setup at a Glance

Task	Where	Who
Enter Linkly credentials	WooCommerce → Settings → Payments → POS Linkly Terminal Gateway	Administrator
Make Linkly the default	Same screen → Default Gateway	Administrator
Rename the POS button	Point of Sale → Settings → Payment → Edit	Administrator
Choose outlets	Point of Sale → Outlets → Edit → Additional Payment Option	Administrator
Pair a till	POS header → Linkly icon	Cashier
Take a payment	POS → Pay → POS Linkly Reader → Confirm Payment & Generate Invoice	Cashier

Frequently Asked Questions

Where do I get the Linkly username and password?

From Linkly, with your Linkly Cloud account. Test credentials are for the Linkly sandbox and live credentials for production. Enter them in the gateway settings.

Where do I find the pair code?

It is shown on the Linkly terminal's pairing screen. Enter it from the Linkly icon in the POS header. See entering the pair code.

Does every cashier need to pair?

Yes. The pairing is saved per POS user, so each cashier pairs once with the terminal at their till.

Can customers pay with Linkly on the online store?

No. The connector only adds Linkly payments to the WooCommerce POS.

What happens to the order if the card is declined?

It stays Pending payment. Select Pay again or take payment another way. See declined payments.

If the guides above did not solve your problem, our support team is ready to help. Reading the pre-ticket checklist first — and noting the exact message the POS showed — usually gets you a faster answer.

Before opening a ticket Submit a ticket Product page

Support portal: webkul.uvdesk.com · Include your plugin version (1.1.0), your WooCommerce Point of Sale version, whether test mode is on, and the exact message you saw.