Payment Terminals and TWINT¶
DiKAS connects card terminals in the same ways as described in the rest of the manual, see Payment Methods and Hardware.
Connections¶
| Route | What DiKAS does |
|---|---|
| Card terminal (ZVT) | Amount is handed to the terminal; void (reversal) and end-of-day batch (Kassenschnitt) from the POS |
| Worldline TIM | Card terminals with the TIM interface (in Switzerland the ep2 terminals): payment, cancellation, status query, turnover query, void and refund from the POS. The connection to the terminal runs through the hardware agent in the terminal's network; the standard port is 7784, no ZVT password is needed |
| O.P.I. (e.g. Nexi Switzerland) | Card terminals with the open O.P.I. interface (Open Payment Initiative), such as the Ingenico Axium RX5000 or Nexi Q30 from Nexi Switzerland: payment, cancellation, void of the payment, refund, end-of-day, subtotal, receipt reprint and connection test from the POS. The terminal's display text appears in the POS waiting window, card receipts come into the POS. Standard ports 20002 (terminal) and 20007 (POS) |
| SumUp | Terminal alternative, amount from the POS |
| Stripe Terminal | including Tap to Pay |
| Softpay | Tap to Pay directly on the Android POS device, without terminal |
Refunds: free at the ZVT, TIM and O.P.I. terminal; Stripe and SumUp refund only to the original payment. ZVT and Softpay pass terminal tips into the POS; SumUp, Stripe Terminal and Stripe Tap to Pay do not report tips back.
Terminal contract
Which cards and which currency a terminal accepts is determined by your contract with the acquirer, not DiKAS. Before ordering, clarify that the terminal is enabled for use in Switzerland.
Setting up TIM
Under Admin → Settings → Hardware → Payment options, tap “Add terminal” and enter the terminal with type TIM, its IP address and the port enabled by Worldline (usually 7784). The terminal must be reachable from the hardware agent in the network. After a cancellation or timeout the POS reports the transaction as unconfirmed — do not charge again; check the status first.
Setting up an O.P.I. terminal (e.g. Nexi)
- Ask Nexi to confirm that the terminal is set up for O.P.I. (not ZVT) and ask for the ports and the WorkstationID (the POS identifier). Usual are port 20002 on the terminal and 20007 on the POS; some setups use 4100 and 4102.
- Under Admin → Settings → Hardware → Payment options, tap “Add terminal”, choose type O.P.I. and enter: the terminal's IP address, Port (terminal), Channel 1 (POS port) and the WorkstationID. If left empty, DiKAS sends
DIKAS01. The network search (“Also O.P.I.”) finds the terminal on 20002, 4100 or 20007. - Channel 1 is the port the terminal uses to send its display texts and card receipts to the POS. The POS must be reachable there from the terminal's network (firewall). Enter 0 if the terminal sends everything over one connection.
- Check with the status button (connection test), then make a test payment of a small amount and void it.
| What you see | What to do |
|---|---|
| “Terminal … not reachable” | Check IP and port on the terminal. Nothing was charged. |
| “No hardware agent with O.P.I. support” | You are using the cloud: pair and update the hardware agent in the terminal's network. It is not the terminal. |
| “Outcome unconfirmed” | Connection lost or timeout: do not charge again; first check on the terminal or the merchant receipt whether the payment went through. |
| “Card declined” | The card was declined, nothing was charged. Use another card or payment method. |
| “Void at the terminal needs the terminal reference” | The payment has no terminal reference (e.g. booked by hand). Void at the terminal or book a refund. |
| Terminal asks questions (e.g. “Signature valid?”) | DiKAS confirms signature questions automatically and shows the text in the waiting window; check the signature on the merchant receipt. Other input requests from the terminal are declined by DiKAS. |
TWINT¶
Your card terminal accepts TWINT like a card payment — the guest scans the code at the terminal or holds the phone to the device. In DiKAS you book the transaction as a card payment; there is no separate TWINT connection of the POS. Whether your terminal accepts TWINT depends on your acquirer.
Seeing TWINT separately in the reports
If your terminal reports the card type back, DiKAS can adopt it as its own payment method in the reports — switch under Admin → Settings → Payments, see Payment Methods.