SwipeSynq logo
Product & How-to

18 July 2026 · 5 min read

PineLabs and Paytm terminal payments inside a modern POS

Initiate, poll, handle failure, retry safely, and keep terminals scoped per location. The unglamorous detail that decides queue speed.

The payment step is the part of checkout customers actually experience. Everything before it — catalog, discounts, tax — happens on your side of the counter. A good payment terminal integration makes that final step short and unambiguous: the amount goes to the device, the result comes back, the order closes.

Initiate: the amount should never be typed

Manual keying is where queue time and disputes come from. When the POS pushes the exact total to a PineLabs or Paytm terminal, the cashier stops being a second point of failure and the transaction is tied to the order from the start. Terminals must be scoped per location, so a device in one outlet cannot be selected from another.

Poll: the honest part of the design

Card and UPI transactions are asynchronous. The POS asks for status on a schedule until it gets a definitive answer, showing the cashier a clear pending state in the meantime. Two rules matter here:

  • Polling must have a bounded lifetime with sensible backoff — a job that retries forever will eventually flood the provider or hide a stuck device.
  • Pending must look different from success. If a cashier cannot tell them apart at a glance, someone will hand over goods against an unconfirmed payment.

Failure and retry, without double charges

Declines are routine; the dangerous case is ambiguity — the terminal timed out and nobody knows whether the customer was charged. The POS should let the cashier void or abandon the attempt explicitly, then start a fresh attempt, with both attempts recorded against the same order. Reconciliation the next morning depends entirely on that trail existing.

A related habit: keep the provider reference on the order. When a customer calls about a charge three days later, that reference is the difference between a two-minute answer and a bank statement hunt.

Mixed tenders are the normal case

Part cash, part card, or a card that declines and a second card that clears — the payment record should be a list of attempts and captures, not a single field. Refunds then reverse against the correct tender rather than defaulting to cash.

Terminals across multiple locations

In a group, terminal management becomes an inventory problem of its own. Register each device against the location it lives in, and give managers a view of which terminals are active. A device that has been moved between outlets without being reassigned will produce settlement that does not match either store's takings.

Tax stays attached

The tendered amount must equal the tax-inclusive total, and the resulting order should carry its tax breakdown intact for reporting — see GST and VAT POS. In India specifically, UPI and EDC volume means most merchants are running this path hundreds of times a day; small friction compounds. The POS software India page covers the local profile.

What to test during a trial

  1. A successful card sale, end to end, timed.
  2. A decline followed by a successful retry on the same order.
  3. A timeout: pull the network mid-transaction and see what the cashier is told.
  4. A partial refund against a card tender.

If all four are clear to someone who has used the system for an hour, the integration is doing its job.

Get started

Start your 14-day free trial

Extend up to 30 days on request. No long-term lock-in.