Clover and card terminal troubleshooting
Before you retry any card action, look at the Clover Flex and check whether money was taken. A dropped connection or a timeout can leave the result unknown, and you must not take the payment again until the result has been settled in FMX EPOS.
Clover is turned off or not ready
Section titled “Clover is turned off or not ready”When the till loses the Flex, a Card Terminal guide appears in the bottom-right corner with three steps: Open Pay Display, Enter Manager PIN and Enter Pairing Code. Keep Pay Display open on the Flex and select Reconnect. If the guide shows a Pairing Code, enter it on the Flex. If the Flex still does not connect, an administrator checks the settings:
- Open Back Office → Diagnostics and read the Clover Bridge card. Manual Card Mode means Clover is not turned on for this terminal.
- In the desktop app, open Back Office → Local Settings → Caller ID & Clover.
- On the Clover Flex card, check that Use Clover Terminal is ticked and that the saved Pay Display Endpoint matches the Flex.
- For a
wssendpoint, check that Clover Device Certificate says “Installed for this Windows user.”. If it does not, select Install and accept the Windows prompt. - Select Save Caller ID & Clover, then Check Status.
- If needed, select Pair / Reconnect. Enter the manager PIN on the Flex if Pay Display asks, then type the Pairing Code shown on the Clover Flex card into the Flex and select Check Status.
Clover Flex
Illustration, not a screenshot. The real screen can differ with the theme or version.
The endpoint is stored on this PC only and can be changed only in the desktop app. If the Flex gets a new address from the router (DHCP), the old endpoint may stop working, so give the Flex a fixed address or a DHCP reservation.
If Bridge Process shows Not running and Recent Errors says “Clover needs .NET Framework 4.8.1, which is not installed on this PC.”, install .NET Framework 4.8.1. Run the same or a newer FMX EPOS installer and select Install .NET Framework 4.8.1 when it finishes; this works without the internet. You can also install it from Microsoft. Restart Windows afterwards, and Clover then starts by itself. Until then the till keeps trading without Clover.
If the Clover Flex card or Recent Errors says “Clover needs a one-time Windows setup.”, this PC needs that setup before Clover can connect. The FMX EPOS installer normally does it; run it again and choose Repair, or ask someone with Windows administrator rights to run the command shown in that message. Then close FMX EPOS and start it again as your usual Windows user.
Pairing does not complete
Section titled “Pairing does not complete”- Finish or cancel any transaction showing on the Flex first.
- Check the Pay Display Endpoint and the Remote Application ID against the merchant’s Clover set-up. POS Name and Serial Number name this till to Clover and must not be empty. Changing any of these four values needs a new pairing code.
- For
wss, install the device certificate for the Windows user that runs FMX EPOS. The saved pairing also belongs to that Windows user: if FMX EPOS now runs under a different Windows user, select Reset Pairing and pair again. - Check in Diagnostics that the Clover bridge is running, and read any message on the Clover Flex card, such as the one-time Windows setup described above.
- Use Reset Pairing only when the saved pairing has to be removed. It asks Reset the saved pairing?: select Confirm Reset, or Keep Pairing to back out. After a reset, Pay Display asks for the manager PIN and a new pairing code.
FMX EPOS will not pair, reset or turn off Clover while the Flex reports a transaction in progress. It says, for example, “Clover Flex is processing a transaction. Pair or repair the connection once it has finished.”
Declined, cancelled, failed or unknown results
Section titled “Declined, cancelled, failed or unknown results”When a card action does not go through, the till shows a message that you close with OK:
- Card Declined (or Card Refund Declined) means Clover refused the transaction. Follow the message and offer another way to pay if appropriate.
- Card Payment Cancelled (or Card Refund Cancelled) means the operation was cancelled on the Flex or from the till, without approval.
- Card Payment Failed (or Card Refund Failed) means the Flex could not be used or reported an error, for example because the request never reached it or Clover refused the request itself. The message gives Clover’s own reason. No money was taken.
- An unknown result means the request may have reached Clover but the final answer was lost or incomplete. The till opens Confirm Card Result instead (see below).
No payments added.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Only an unknown result needs you to decide whether money was taken. Never turn a known decline into a manual success.
If Cancel Card does not stop the payment, the till says “Clover Flex did not confirm cancellation after 3 attempts. Check the terminal and cancel the transaction there.” and the button becomes Retry Cancel. Cancel on the Flex, then select Retry Cancel if the till is still waiting.
Settle an unknown payment
Section titled “Settle an unknown payment”When a card result is unknown, the till that sent it opens a Confirm Card Result window. The window also opens at sign-in and keeps coming back while this terminal has an unknown result waiting. It has no close button: it closes only when you answer it or select Sign Out.
No payments added.
Illustration, not a screenshot. The real screen can differ with the theme or version.
- Leave the order and payment screen as they are.
- Check the transaction history on the Flex, or the merchant records.
- For a payment, select Check Terminal to ask Clover whether it went through.
- If Clover still cannot answer, select Money Was Taken or Money Was Not Taken according to what the records show. For a refund, the buttons read Refund Was Made and Refund Was Not Made.
If the database is unavailable at that moment, the till shows Card Payment Result Unknown (or Card Refund Result Unknown) with OK instead. Confirm Card Result follows once the database answers.
An administrator can also settle unknown results in Back Office → Orders → Payment Review. Check Terminal works only on the terminal that sent the request. Refunds cannot be looked up at all, so check the card and merchant records before you settle an unknown refund.
If someone chose the wrong answer, an administrator can correct it within seven days under Resolved Card Results in Back Office → Orders → Payment Review, with Correct to Taken or Correct to Not Taken (Correct to Made or Correct to Not Made for a refund). A payment corrected to not taken is removed from its order and the order reopens for payment; a refunded or otherwise changed order is refused. See Payment review and manual card transactions.
How the Flex behaves with FMX EPOS
Section titled “How the Flex behaves with FMX EPOS”FMX EPOS sets these on every card payment, whatever the merchant’s Clover dashboard says:
- The Flex does not ask for a tip. Take any tip on the till’s payment screen before the card, and it is included in the amount sent to the Flex.
- The Flex does not offer cashback.
- The Flex does not print or offer a receipt. Card slips print on the till’s receipt printer (see The card slip does not print).
- The Flex must not store a payment offline for later. Without a connection it declines the card. If it stores a payment offline anyway, the till treats the result as unknown and opens Confirm Card Result: check Clover’s transaction history before you answer.
A successful card payment has no order
Section titled “A successful card payment has no order”On the till that took the card, open Cash & Card → Payment Review → Card Payments Without an Order and check the Flex history first. Then:
- It belongs to an unpaid order: enter the order number and select Record Payment.
- It was a table’s payment: Record Payment will not accept it, because a table is paid on its own payment screen. Select Terminal Refund, then take the table’s payment again in the normal way.
- The order is already paid: select Terminal Refund to give the money back.
- It was a membership payment with no saved renewal: select Terminal Refund.
Card Payments Without an Order1
- •••• 482114:05 · CLV-8KQ2£12.40
Illustration, not a screenshot. The real screen can differ with the theme or version.
Back Office → Orders → Payment Review shows the same list and can record a payment on an order, but a refund on the terminal can only be made from the till that took the card.
Use a separate card terminal
Section titled “Use a separate card terminal”- Clover is turned off for this terminal: every card payment or refund asks you to take it on the separate card machine first, then select Card Taken or Card Refunded to record it.
- Clover is on but not ready: the till shows Clover Flex Not Ready. Select Retry Terminal to check Clover again. If it still cannot be used, take the money on a separate card machine and select Record External Payment (or Record External Refund). Go Back records nothing.
No payments added.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Recording a card payment taken on another machine needs the Manual Card / Card Not Present permission; without it, the till asks for a manager’s PIN. Recording only enters the transaction in FMX EPOS and does not connect to the separate machine, so complete the transaction there first and keep its merchant receipt. See Payment review and manual card transactions.
The card slip does not print
Section titled “The card slip does not print”The Flex does not print the FMX EPOS card slip, and FMX EPOS does not print one by itself after an order’s card payment. To print one, open the order in Orders on the till and select Card Receipt next to the payment. Payments recorded by hand, or taken on a separate machine, have no card slip. A slip prints automatically only for a manual card payment or refund made from the till’s Card workspace.
If a slip does not come out, check this terminal’s receipt printer, the Card Slip Template in Local Settings → Printers and the Print Queue. A payment can be approved and saved even if its slip then fails to print, so recover the print job and do not repeat the payment.