Payment Device Issues

Updated 4 days ago · 2 min read

Use this guide when a payment-gated FMX workflow does not start, times out, or approves at the wrong amount.

First Checks

Open FMX > Global Settings > Devices > Payment Terminal.
Confirm Payment Provider is one of None, Nayax, Pulse, Shopify, or Stripe.
For Nayax or Pulse, confirm the COM port appears in Windows Device Manager > Ports (COM & LPT).
Confirm the workflow payment amount is in dollars or local currency units.
Run a test transaction with the exact workflow used at the event.

Symptom	What to check
Terminal does not prompt	Power, COM port, baud rate, USB/serial cable, and Nayax terminal profile.
Payment times out	Terminal network, Nayax account status, and whether another app is using the COM port.
Wrong amount	Workflow payment amount, currency, and provider default amount.
Approved payment does not advance	Save FMX logs and provide the transaction time to Foto Master support and Nayax.

Nayax settlement, refunds, chargebacks, and terminal reporting are handled in Nayax systems.

Use this section for coin, token, Intercard, Embed, or other controllers configured to output pulses.

Symptom	What to check
No approval	COM port, baud rate, wiring, controller power, and whether pulses are being emitted.
Approves too early	Cents Per Pulse is too high, or the controller emits too many pulses per play.
Approves too late	Cents Per Pulse is too low, or the controller emits too few pulses per play.
Coin/token rejected	Clean or recalibrate the external coin/token hardware.
Venue card approved but booth waits	Ask the venue administrator to confirm the controller outputs pulses after approval.

FMX counts pulses. Configure coin denominations, token rules, Intercard rules, or Embed rules in the external system.

Symptom	What to check
QR/checkout does not appear	Provider is selected, Cloud is authenticated, and the provider account is connected.
Guest pays but booth waits	Booth internet connection, provider webhook/Cloud connection, and FMX logs.
Checkout expires	Increase timeout if appropriate and confirm the guest can complete payment within the configured time.
Refund needed	Use Shopify Admin or Stripe Dashboard.