Payment terminals (USA) — Paloma POS 2

This article is about Paloma POS 2 — the new Paloma register app — and how to take card payments in the USA: through Valor, PAX, Netevia (including the PinPad variant), Sunmi/TSYS, ChargeAnywhere, and Forte (Ashburn) terminals. It also covers how to close the batch (settlement) at the end of the day, where to review your close-batch history, and what to do when a terminal doesn't respond. If you're not sure which product you have, start with «How to tell you have Paloma POS 2». For taking payment on an order in general, see «Paying for an order».

Overview

Card payments in Paloma POS 2 run through a payment terminal bound to the register. The register sends the amount to the terminal, waits for the bank's response, and closes the check — the cashier never keys the amount on the terminal by hand. Several providers are supported:

• «Valor Terminal» — a Valor terminal (bundled SDK or semi-integration over WebSocket).
• «Sunmi (TSYS)» — a Sunmi device processing through TSYS.
• «Netevia (cloud)» and «Netevia PinPad» — the Netevia cloud integration and its separate-PinPad variant.
• «ChargeAnywhere (cloud)» — the ChargeAnywhere cloud integration.
• «Forte (Ashburn)» — the Forte integration via Ashburn.
• PAX-based hardware connects through its provider (for example, Netevia on a PAX device).

At the end of the day you close the batch (settlement) on each card terminal — the day's transactions are sent to the bank to be funded. This is a separate step from closing the cash shift and printing the Z-report; see «Closing the shift and Z-report».

Setting up a terminal

An administrator adds and configures each terminal once:

1. Open Settings → «Payment Devices» → «Add device».
2. Pick the provider — «Valor Terminal», «Sunmi (TSYS)», «Netevia (cloud)», «Netevia PinPad», «ChargeAnywhere (cloud)», or «Forte (Ashburn)» — and fill in the connection fields (Valor needs an EPI ID and IP; Netevia needs GMID/GTID; ChargeAnywhere needs a Terminal ID and Merchant ID).
3. Verify the link with «Test connection»; «Find terminals on the network» discovers terminals on the same Wi-Fi.
4. In the payment-types block, tick which tenders route through this terminal. If one tender is served by several terminals, star one as «Default».
5. If the provider supports end-of-day auto settlement, turn on «Auto-batch» and set a time — the batch will then close on its own.

If the list is empty, the register shows «Add a payment terminal to take card sales.» The message «This build does not bundle any payment-terminal SDK. Reinstall from the matching store (Sunmi App Store, Valor App Store) to add a card terminal.» means the app was installed from the wrong store for your hardware — reinstall the build that carries your terminal's SDK.

Taking a card payment

1. On the order card tap «Pay order» → «Card».
2. If several terminals exist, the register shows «Choose a payment terminal» — pick one (the default is marked «Default»).
3. The register sends the amount to the terminal and shows «Insert card / processing...». Let the customer tap, insert, or swipe the card on the terminal (or on the PinPad for Netevia PinPad).
4. Wait for the bank's response. On success you'll see «Payment complete».

While processing, don't remove the card or leave the screen. If the terminal declines, the order stays open — you can retry, pick another terminal, or take cash. Partial and mixed card payments are supported too — see «Paying for an order».

Tips on the terminal

How the terminal prompts for a tip depends on the tip-moment setting:

• Before the charge — «Operator picks the tip first; the terminal charges the total + tip.»
• After the charge — «Terminal charges the order first; the tip is captured locally afterwards.»

Tips roll into the day's batch total and appear on their own line when you close the batch.

Closing the batch at end of day

At the end of the day, close the batch on each card terminal — this sends the day's transactions to the bank for settlement. Where to go:

• «Shifts» section → «Close batch».
• Or the Z-report screen → the «Close Batch» button.
• Or from the «Close-batch history» screen, using its close-batch action.

Steps:

1. Start the close. If several terminals exist, the register shows «Close batch — select terminal» — pick one.
2. The register asks «Close batch?» and shows the day's totals — order count, sales, and tips.
3. Confirm. The register contacts the terminal and settles the batch, showing «Closing batch…» while it works.
4. On success you'll see «Batch closed.» (or «Batch settled by terminal (ref …).» with the settlement reference) and «Batch report sent to printer.»

If there were no paid orders that day, the register shows «No paid orders today — nothing to report yet.» — there's nothing to close. When «Auto-batch» is on, the terminal settles at the configured time; a manual close is then optional but still available.

Close-batch history

Every close on this register is kept under «Close-batch history». Each entry breaks down into «Sales», «Tips», «Refunds», and «Voids». A period summary opens from the «Shifts» section → «Batch report», where you pick a range (Today, Last 7 days, Last 30 days) and a specific terminal. Use it to reconcile the day's takings against your bank statement. Note that closed-batch card transactions can no longer be voided — issue a refund instead.

When a terminal doesn't respond

If a terminal doesn't respond during a payment or a batch close, the register shows «Terminal didn't respond» with the note «The card terminal didn't confirm the settlement in time. Reconcile from the terminal's own report before retrying.» Check the terminal's own report first — the transaction may have gone through on the bank's side. Only once you've confirmed there was no charge should you retry, so you don't double-charge or double-settle.

General steps when the link to the terminal drops:

• Confirm the terminal is powered on and on the same Wi-Fi network as the register.
• Re-check the link with «Test connection» in the device settings, or locate it with «Find terminals on the network».
• If an operation is stuck, finish or cancel it on the terminal itself, then retry from the register.
• When in doubt, take cash and reconcile the card side later from the terminal's report.

Common problems

• «Card terminal error. Please try again.» — the terminal returned an error. Retry the payment or pick another terminal.
• «Card declined. Please try a different card or pay cash.» — the bank declined the card. Ask for another card or take cash.
• «Card terminal timed out. Check the device or batch report before retrying.» — the terminal didn't answer in time. Reconcile against its report before retrying so you don't charge twice.
• «Terminal not available. Check the device or pay cash.» / «Card payment failed: terminal offline» — the register can't see the terminal on the network. Check power and Wi-Fi; no money was charged — retry or take cash.
• «Payments are blocked on the terminal. Make sure Kaspi Kassa isn't running on top of the integration, or contact your provider's support.» — a third-party app is running over the integration. Close it or contact the provider.
• «The terminal hasn't finished the previous operation. Finish or cancel it on the device, then try again.» — an operation is still open on the terminal. Finish it on the device, then retry from the register.
• «Card payment cancelled.» — the operation was cancelled on the terminal. The order stays open — retry the payment.
• «Terminal didn't respond» / «Settlement failed» while closing the batch — the batch didn't settle. Reconcile from the terminal's own report and retry; if it fails again, message us here — a specialist will join.
• «No paid orders today — nothing to report yet.» — there were no card sales that day, so there's no batch to close.

FAQ

How is closing the batch different from closing the shift?

Closing the shift is a register operation: it checks your checks, prints the Z-report, and ends the working day (see «Closing the shift and Z-report»). Closing the batch is a terminal operation: the day's card transactions are sent to the bank to be settled and funded. They're separate steps, though you usually close the batch at the end of the day too.

Do I have to close the batch by hand every day?

If «Auto-batch» is enabled on the terminal, it settles on its own at the configured time. Otherwise, close it manually from «Shifts» → «Close batch», or with the «Close Batch» button on the Z-report screen.

Was the card charged if the terminal didn't respond?

It might have been — the response can be lost after the charge already landed. Check the terminal's own report or your «Close-batch history» first, and only retry once you've confirmed there was no charge. The message «The card terminal didn't confirm the settlement in time…» warns about exactly this.

Where do I see the totals for closed batches?

Under «Close-batch history» — each close shows «Sales», «Tips», «Refunds», and «Voids». A period summary is in the «Batch report» under the «Shifts» section.

The card won't go through — how do I still take payment?

Try another card or take cash — the order stays open until the whole balance is paid. Partial and mixed payments (part card, part cash) are supported; the steps are in «Paying for an order». Your shift's cash totals are in the «Cash report».