Using Nayax with FMX

This article explains how to set up a Nayax payment terminal with FMX, how to add a payment step to your workflow, and what to check before running live payments.

Before You Start: Confirm Your Nayax Terminal Is Configured for FMX

Before testing payments in FMX, contact Nayax OEM Support or your Nayax representative and ask them to confirm that your terminal is using the current Foto Master FMX Marshall configuration.

This step is required for new FMX installations and is especially important if the same Nayax terminal was previously used with FMBooth or another older Foto Master product.

FMX uses an updated Nayax configuration. A terminal that is still assigned to an older Foto Master / FMBooth profile may not work correctly with FMX, even if the COM port and FMX settings are correct.

Send Nayax these files:

• Nayax certification letter
• FMX machine configuration spreadsheet

You should also provide Nayax with:

• Terminal serial number
• Nayax account/operator details
• Country
• Currency
• Event or product price you plan to charge

You can send Nayax the email template at the bottom of this article.

Foto Master Nayax Certification

Foto Master completed Nayax technical validation for the FMX Marshall integration.

The certified configuration is:

The certification applies to the specific FMX implementation and configuration validated by Nayax. If the terminal profile or protocol configuration is changed, Nayax may require re-validation.

FMX Desktop Setup

1. Open FMX.
2. Go to Global Settings > Devices.
3. Set Payment Provider to Nayax.
4. Set COM Port to the port used by the Nayax terminal.
   • If needed, click Refresh Ports.
5. Set Baud Rate to 115200.
6. Set Currency (ISO 4217), for example:
   • USD
   • EUR
   • ILS
7. Set Default Amount (cents) only as a fallback amount.
   • Example: 500 means 5.00 in a 2-decimal currency.
8. Set Product Code if Nayax provided one.
   • If Nayax did not provide a different product code, use 1.
9. Leave Debug Enabled off during normal production use.
   • Enable debug only when Foto Master or Nayax support asks for diagnostic logs.
10. Click Save Changes.

Workflow Setup

Add a Payment trigger at the point in the workflow where the customer should pay.

Set the Payment Amount in regular currency units.

Example:

5.00

FMX automatically converts the workflow amount to the smallest currency unit before sending it to Nayax.

When the workflow reaches the payment step:

1. FMX arms the Nayax terminal.
2. The Nayax terminal prompts the customer to present a card.
3. The customer taps, inserts, or swipes the card.
4. Nayax approves or declines the transaction.
5. If the payment is approved, FMX automatically continues to the next workflow step.

Nayax Configuration Checklist

Nayax should use the FMX machine configuration spreadsheet as the source of truth.

Do not manually change country, payment-kernel, SIM, MQTT, or account-specific settings unless Nayax instructs you to do so.

The most important values to confirm are:

Note: The Nayax-side default credit is only a default setting. FMX sends the actual transaction amount from the workflow payment step.

Testing Before a Live Event

Before using Nayax at a live event, complete this checklist:

1. Confirm Nayax has applied or validated the FMX configuration.
2. Power-cycle the Nayax terminal after Nayax updates the profile.
3. Open FMX and confirm Payment Provider is set to Nayax.
4. Confirm the correct COM Port is selected.
5. Confirm Baud Rate is set to 115200.
6. Confirm the currency is correct.
7. Confirm the workflow payment amount is correct.
8. Run a small test payment.
9. Confirm the payment appears in Nayax reporting.
10. Confirm FMX automatically advances to the next workflow step after approval.

Troubleshooting

Information to Collect for Support

When opening a support case, include:

• FMX version
• Nayax terminal model and serial number
• COM port selected in FMX
• Currency
• Payment amount
• Date and time of the failed test
• Screenshot or export of the Nayax terminal configuration, if available
• FMX logs containing [PAYMENT][NAYAX] and [NAYAX] entries

Email Template to Send Nayax

Subject: Update Nayax terminal configuration for Foto Master FMX

Hello Nayax Support,

We are setting up this Foto Master booth with FMX and need the Nayax terminal configuration updated or confirmed for the current Foto Master FMX Marshall integration.

Please apply or verify the FMX machine configuration spreadsheet:

https://docs.google.com/spreadsheets/d/1vglNEkojZgB_3AbwbJ12MCS1vp9eyUyQ/edit?usp=sharing&ouid=117304131655395103077&rtpof=true&sd=true

Foto Master also has a Nayax certification letter for this implementation:

https://drive.google.com/file/d/1odYftJiFxKb_mpxplZmURspnRKNAFTWN/view?usp=sharing

Key profile details:

• Nayax machine model name / ID: 306727101
• Machine model: RS232 - PC Machine - Marshall VPOS T\O\F
• Machine type: Photo Booth
• Certified feature/profile: Marshall Single Session PreAuthorization
• Marshall UART baud rate: 115200
• Cashless MDB address: Marshall VMC

Please confirm once the terminal is updated and ready for FMX testing.

Thank you.