Payment Settings (Devices Tab)

Updated 5 days ago · 5 min readAdvanced

FMX payment settings are configured in Global Settings > Devices by expanding the Payment Terminal card. The current FMX Windows sidebar does not include a separate Payment tab.

FMX supports multiple payment providers, allowing you to charge guests per session using card readers, coin acceptors, or cloud-based payment platforms.

Payment Providers

FMX supports the following payment providers, selected via the Payment Provider dropdown in the Payment Terminal card:

ProviderTypeConnectionInternet Required
NoneDisabled--No
NayaxCard reader terminalSerial (COM port)No
PulseCoin/token acceptorSerial (COM port)No
ShopifyQR checkoutCloud relayYes
StripeStripe ConnectCloud relayYes

Select "None" to disable payment processing entirely. When a payment provider is active, you can add a Payment trigger to your workflow edges so that steps advance only after a successful payment.

Nayax Card Reader Settings

Nayax is a cashless payment terminal commonly used in vending and self-service kiosks. FMX communicates with Nayax devices over a serial (COM) port using the Marshall protocol.

When Nayax is selected, the Devices tab exposes these settings:

  • COM Port -- The serial port your Nayax device is connected to (e.g., COM18). Check Windows Device Manager to find the correct port.
  • Baud Rate -- Communication speed. Default is 115200. Only change this if instructed by Nayax support.
  • Currency -- ISO 4217 currency code (e.g., USD, EUR, ILS). This must be explicitly configured; FMX will not default to any currency.
  • Default Amount (cents) -- The price per session in cents. For example, 500 equals $5.00.
  • Product Code -- Optional identifier sent to the Nayax terminal. Default is FMX1.
  • Debug Enabled -- A Support troubleshooting option for Nayax communication. Leave this off unless Foto Master support asks you to enable it.
  • Dump Packets Level -- Controls the detail level for Nayax support logs. Leave this set to None unless Foto Master support asks you to change it.

Nayax flow mode, machine identity, denial cooldown, pre-authorization flags, multi-session flags, and simulator controls are not normal operator controls in the current Windows UI. Treat them as support-managed or technician-only settings.

Pulse (Coin/Token Acceptor) Settings

The Pulse provider works with Arduino-based pulse counters connected via the serial port. Each physical pulse (coin drop or token insert) increments a counter toward the configured price.

  • COM Port -- The serial port your pulse counter is connected to (e.g., COM8).
  • Baud Rate -- Communication speed. Default is 9600.
  • Cents Per Pulse -- The monetary value of a single pulse in cents. For example, 25 means each coin/token is worth $0.25.
  • Approval Timeout (seconds) -- Maximum time to wait for enough pulses before timing out. Set to 0 to disable the timeout.

Tip: To calculate how many coins a guest needs to insert, divide the experience price (from the workflow) by the Cents Per Pulse value. For example, a $5.00 experience with 25 cents per pulse requires 20 coin insertions.

Shopify QR Checkout Settings

Shopify integration allows guests to scan a QR code on screen and pay on their phone. FMX polls Foto Master Cloud for payment confirmations relayed from Shopify.

  • Shop Domain -- Your Shopify store domain (e.g., my-store.myshopify.com).
  • Poll Interval (ms) -- How frequently FMX checks for payment confirmation. Default is 2000 (2 seconds).
  • Approval Timeout (seconds) -- Maximum time to wait for payment approval. Default is 300 (5 minutes). Set to 0 to disable timeout.
  • Simulator Enabled -- Auto-approves payments after a delay for testing purposes.
  • Test Connection -- Checks whether FMX can reach the Shopify payment relay using the current cloud login and license.

Stripe Connect Settings

Stripe Connect integration lets you accept payments through your Stripe account, with FMX polling the cloud for confirmations.

  • Poll Interval (ms) -- How frequently FMX checks for payment confirmation. Default is 2000 (2 seconds).
  • Approval Timeout (seconds) -- Maximum time to wait for payment approval. Default is 300 (5 minutes). Set to 0 to disable timeout.
  • Simulator Enabled -- Auto-approves payments after a delay for testing purposes.
  • Test Connection -- Checks whether FMX can reach the Stripe payment relay using the current cloud login and license.

Tip: Stripe Connect and Shopify POS require your account to be connected through Foto Master Cloud (cloud.fotomaster.com) before configuring in FMX.

Setting Pricing Per Experience

Payment amounts are configured at two levels:

  1. Default amount -- Set in the Payment Terminal settings in the Devices tab (e.g., Nayax Default Amount or calculated from Pulse settings).
  2. Per-workflow pricing -- Configure specific prices in your workflow using the Payment trigger on edges between steps. The amount specified in the workflow overrides the default.

To add a payment gate to your workflow:

  1. Open your experience in the Workflow Builder.
  2. Select the edge (connection) where payment should occur.
  3. Set the trigger type to Payment.
  4. Configure the amount in cents and currency.

Pay-Per-Use Mode vs Event Mode

FMX can operate in two overall modes regarding payment:

  • Pay-Per-Use Mode -- Payment provider is active. Each guest must pay before using the booth. Use this for public installations, malls, and unattended booths.
  • Event Mode -- Payment provider set to "None." The booth runs freely without charging guests. Use this for private events, weddings, and corporate functions where the host covers the cost.

Tip: You can switch between modes by simply changing the Payment Provider setting. No other workflow changes are needed if your workflow uses conditional Payment triggers.

Testing the Payment Flow

Before deploying to an event:

  1. For Shopify or Stripe, enable the Simulator if you want to test without a real checkout. For Nayax or Pulse, use the physical device or a support-provided test setup.
  2. Run your experience from the main dashboard.
  3. Verify the workflow pauses at the Payment trigger step and advances after simulated approval.
  4. If payment still does not advance, collect the FMX logs  C:\FMX\Logs for Foto Master support.
  5. Disable simulator mode and test with the actual payment path before going live.

See also: Devices Tab, Workflow Builder Overview, Experience View

Was this helpful?

Related articles