Card terminals and acquiring — Paloma365 Classic (Windows POS)
Paloma365 Classic, the Windows POS application, talks to bank card terminals directly: the POS sends the amount to a Kaspi, Halyk, or other bank terminal, so the cashier never retypes it on the terminal. This prevents entry mistakes and speeds up checkout.
Supported terminals
Kaspi, Halyk (including the "Halyk Restaurants" option connected via a Pairing Code), Forte, Freedom, Alatau, Alsep, BCC (Bank CenterCredit; the checkbox is «Использовать БЦК»).
The terminal connects over the local network: POS and terminal must be on the same network (same router), and the POS reaches the terminal by its IP address on port 8080 — if the network has a firewall, this port must be open.
Connecting a terminal
- Open the POS settings, "Plugins" tab.
- Enable the checkbox for your bank, e.g. "Use Kaspi" or "Use Halyk".
- Press the button next to the checkbox — "Settings" (for Kaspi and Alsep it is labelled "Connection test") — and fill in: IP Address of the terminal, the payment type the receipt will be closed with (card by default), and manual confirmation (Yes/No). Manual confirmation is a single POS-wide setting shared by all connected terminals, whichever bank's settings window you change it from. The optional «Номер терминала» (terminal number) field lets the POS find exactly your terminal on the network; usually you do not fill it in — after a successful connection test the POS remembers the number itself.
- Press "Connection test". On success the POS reports the settings are saved; "Terminal not connected!" means the IP or the network needs checking. "Cancel" in this window, like a failed test, unchecks the bank's checkbox — the terminal is turned off and has to be enabled and set up again.
You do not have to look up the IP address. The «Поиск в сети» (search the network) button in the same window finds the terminal on the local network (the search takes up to 30 seconds) and fills in its address. One terminal found — the POS shows its address and number; several — a «Найденные терминалы» (found terminals) list opens, pick yours (or «Искать ещё раз», search again); none — "no terminals found on the network". When the terminal number is already filled in, the POS searches for exactly that terminal. A warning that the number is already configured for another bank means this terminal is already assigned to a different bank in the POS settings. After the search, press "Connection test" to save the address.
Paying by card
- The cashier builds the order and selects the payment type linked to the terminal.
- The POS sends the amount — the screen shows "Waiting for payment via terminal".
- The customer taps the card (or pays by QR if supported).
- On success the POS shows "Transaction completed successfully" and closes the receipt.
The amount sent to the terminal is rounded to a whole number, so the terminal amount may differ slightly from the receipt total.
If the terminal sends no answer, the POS first checks whether it is reachable at its current address. If it is, the POS says the terminal is online but did not answer in time — check on the terminal whether the payment went through before repeating it — or that an operation is in progress on the terminal. If it is not reachable (e.g. the router gave it a new IP after a restart), the POS asks «Отсутствует подключение с банковским терминалом! Провести автоматический поиск?» (no connection to the bank terminal — run an automatic search?) and, on yes, finds the terminal on the network and remembers the new address. For Halyk, Forte, Freedom, Alatau and BCC, if the request never reached the terminal and exactly your terminal was found, the POS repeats the operation itself; otherwise it asks you to check the terminal and repeat the operation manually — this prevents charging the customer twice.
If the payment fails, the POS shows the terminal's error with buttons "Retry", "Pay manually" (the POS asks to confirm the payment on the terminal; for Kaspi the button is shown only when manual confirmation is enabled, for the other banks it does not depend on that setting: for Alsep it is visible in the payment window from the start, for Halyk, Forte, Freedom, Alatau and BCC it appears together with the other buttons after an error or a decline from the terminal), "Cancel", and «Найти терминал в сети» (find the terminal on the network) — shown when the terminal did not respond (Kaspi, Halyk, Forte, Freedom, Alatau, BCC); it runs the same network search, after which you repeat the operation.
Refund to card
Refunds also go through the terminal. For Kaspi the cashier selects "Card" or "QR code", enters the transaction code of the original payment, and presses "Refund". For Halyk, Forte, Freedom, Alatau and BCC the POS fills in the original transaction code automatically from the receipt's payment data — when the code is found, the input field is hidden; manual entry is needed only when that data is missing. The Alsep terminal asks for the transaction code on refund: "Введите RRN" (enter the RRN).
Important: for Forte, Freedom and BCC a refund made within the same POS shift as the payment is performed as a cancellation of the whole payment — a partial refund is not possible in that shift. The POS shows the message "Терминал HALYK поддерживает только полный возврат средств по чеку, выберите Все товары и повторите операцию" (the terminal supports only a full refund — select all items and retry; the text mentions HALYK even when the terminal is Forte, Freedom or BCC). Select all items and retry, or make the partial refund in a later POS shift.
Refund without the terminal
If the refund fails on the terminal (the terminal is unreachable or returns an error), the POS asks: "Process refund without the terminal KASPI?" (KASPI is replaced with your bank's name — HALYK, FORTE, FREEDOM, ALATAU, ALSEP, or BCC) and shows the error text. "Yes" — the return receipt is completed in the POS without the terminal; the money is not refunded to the customer's card automatically and must be refunded separately (e.g. manually on the terminal itself). "No" — the return is aborted.
Settlement / closing the day
For Halyk, Forte, Alatau, Freedom, and BCC the "Plugins" tab has a "Close shift" button that closes the bank day from the POS. Kaspi and Alsep are settled on the terminal itself.
Common problems
- Terminal not responding (the settings window shows "Terminal not connected!"; during payment the POS shows a "Response from POS-terminal" message with the error text): check the terminal is powered on and on the same network as the POS. If the router reassigned its IP, find it with «Поиск в сети» in the terminal settings (or accept the automatic search during payment). Rerun "Connection test".
- The terminal answers but is busy with another operation — an unfinished operation is hanging on the terminal. Finish or cancel it on the terminal itself and retry the payment.
- "Invalid response from POS-terminal" — the terminal answered, but the POS could not parse the response (it came back empty or corrupted). Check the connection between POS and terminal and retry; first check on the terminal whether the payment actually went through.
- "ALSEP terminal is not avaiable and will be turned off, please check the connection settings!" — the POS periodically checks the connection to the Alsep terminal; if it does not respond, the POS shows this message and unchecks "Use Alsep" by itself. Once the connection is restored, re-enable the checkbox and run "Connection test".
- Payment stuck: check on the terminal whether the payment went through. If yes — "Pay manually" and confirm; if not — "Cancel" and retry.
- Totals differ: close the shift and compare the terminal's settlement report with POS reports; the usual cause is a payment made on the terminal bypassing the POS. Ask the bank about disputed transactions.
QR payments
Kaspi and Halyk also accept QR payments — same flow on the POS; on refund the cashier chooses "Card" or "QR code".
The separate Kaspi QR service is enabled not in the POS settings but on the Paloma365 side — the POS receives the activation flag from the cloud when it signs in. Kaspi QR requires the POS to have a permanent internet connection.
The QR payment slip does not print
The message "Error printing the QR code!" appears when the POS could not print the bill carrying the QR code. The exact error text follows it and tells you which case it is:
- "Report file not found …" — the print-form template is missing or damaged on this computer. Update the program: Installation and updates.
- any other text — the printer itself did not respond. Check the paper and the connection to the printer.
The failure concerns this form only — the QR bill; ordinary receipt printing goes its own way.
BePay — QR payment (Kyrgyzstan)
BePay is QR-code payment for Kyrgyzstan. No terminal is needed: the POS gets the QR code through the Paloma365 cloud, so internet is required. On the "Plugins" tab it is the «BePay (QR, Кыргызстан)» checkbox — it cannot be clicked: the service is enabled on the Paloma365 side (when it is not, the label says BePay is disabled in the cloud).
The "Settings" button opens a window with «Merchant-id:», «Merchant-secret-key:» (the merchant keys issued by BePay) and «Вид оплаты:» (payment type). After "Apply" the POS saves the keys and checks them: either the keys were accepted by the BePay gateway, or the connection check failed, with the reason. Without a payment type BePay payment is unavailable.
How payment works: the cashier selects the BePay payment type, the POS gets a QR code and prints it on the receipt printer as a separate slip — hand the slip to the customer. A countdown of the remaining seconds is shown on screen. The customer scans the QR, the POS waits for confirmation and closes the receipt. If time runs out, the POS says the wait expired and, if the money was charged, to confirm the payment manually; the "Pay manually" button is visible when manual confirmation is enabled. "Retry" on a still-valid QR does not issue a new code but reprints the slip (the POS asks you to take the old slip back from the customer). When you close the window, the POS warns that the customer can still pay with the issued QR.
Limitations:
- BePay cannot be used in a mixed (split) payment — the gateway has neither cancellation nor refund.
- There is no automatic refund to the customer's account. When such a receipt is returned, the POS reminds you of that — give the money back in cash or another way, and process the return in the POS as usual.
Halyk Restaurants
"Halyk Restaurants" is a QR order-payment service via Halyk. It is paired via a Pairing Code and requires internet on the POS; like Kaspi QR, the activation flag comes from the cloud when the POS signs in. On the "Plugins" tab it corresponds to the "Использовать Halyk Рестораны" (Use Halyk Restaurants) checkbox.
The "Settings" button next to the checkbox opens the connection window with:
- Pairing Code — the pairing code issued by Halyk;
- Payment type — which payment type the receipt will be closed with (card by default); cash, deposit, and credit ("on account") types are not offered;
- Menu — which POS menu the service should use.
If a suitable payment type does not exist yet, it can be created right from the POS: a small button next to the payment type field opens a creation window with the fields "Name" (pre-filled "Halyk Рестораны"), "Банковский счёт" (bank account), and a "Fiscal" switch (on by default). Creating requires internet — without it the POS shows "No internet connection...".
After pressing "Apply" the POS performs the handshake with the service: on success it shows "Рукопожание с Halyk Рестораны прошло успешно!" (handshake succeeded), on failure — "Не удалось провести рукопожание с Halyk Рестораны" (handshake failed) with the service's response text (check the pairing code and the internet connection).
FAQ
Can I connect terminals from several banks to one POS?
Yes — each bank has its own checkbox on the "Plugins" tab and its own payment type.
The POS stopped seeing the terminal after a router change
The terminal got a new IP address. Enter the current IP in the terminal settings and run "Connection test".