Set Up Nayax Core for Marshall Integration

Once you have completed the Marshall installation process, follow the steps below to
configure the Nayax device to support the Marshall functionality.

Configure the Machine Model at the Machine Level

This configuration lets your system interact properly with the selected devices, ensuring efficient and optimal operation. Below are the necessary steps to configure the machine model:

Log in to Nayax Core using your credentials.
Go to Operations > Machines.
Create a machine. If you need help, see the Create New Machine guide.
In the Machine Model field, select one of the following options from the dropdown:
- RS232 – PC Machine - Marshall (Amit device)
- RS232 – PC Machine - Marshall VPOS T/O/F (for Touch devices)
Click Save to apply the configuration.

Configure RS232 Connection

Set the serial port parameters for your machine:

For the machine you configured, click the General tab.
Locate the RS232 Control section and configure the required settings.

Configure Session Timeout Parameter

The Multi-Session Mode operates only in pre-selection mode but functions similarly to pre-authorization. The transaction flow is akin to a single vending process, with the addition of a Close Session command.

If your machine works in the multi-session mode, set the session timeout parameters as follows:

For the configured machine, click the General tab.
Go to the VMC section.
Define the Session Time Out to specify the session’s duration:
- Maximum for Credit Cards: 23 hours
- Maximum for Prepaid Cards: 72 hours
- Default: 60 minutes

📘
Session Expiration and Settlement
Once the session timeout reaches the defined limit, the session expires. In such cases, the settlement amount will correspond to the price sent during the vend request command.

Configure Keep Alive Parameter

The Keep Alive signal ensures consistent communication between the Nayax device and the machine by sending a signal every second. Adjust the parameters to enhance the system's tolerance as follows:

For the configured machine, click the General tab.
Go to the VMC section.
Set the Keep Alive Intervals (in seconds) to define the communication timeframe between the device and the machine (maximum: 255 seconds).

📘
Keep Alive Communication Failure
If the device doesn’t receive the Keep Alive command within the time defined, then communication is failed, and the device will launch a Pairing process and send the Reset command again.

Configure Cashless Address

The Cashless Address configuration ensures seamless communication between the machine and the Nayax device for cashless transactions. Follow these steps to set the correct address:

For the configured machine, click the General tab.
Click the MDB section.
Select the Cashless MDB address to Marshall VMC.

Configure Pre-Selection and Pre-Authorization

Pre-selection and Pre-Authorization settings allow flexible transaction flows tailored to different vending scenarios. Pre-selection enables multi-session operations, while Pre-Authorization focuses on card-based transactions with a defined credit limit. Configure these parameters as needed for your machine’s functionality.

Pre-Selection - Multi-Sessions

Pre-selection supports multi-session operations where consumers can select products before completing the transaction. To configure this:

For the configured machine, click the General tab.
Click the MDB section.
Select the MDB Flags to PreSelection Enabled.

This allows the system to offer product preselection before making a payment.

The Choose Product Timeout option is the timeframe that the consumer is required
to choose a product.
When the transaction flow starts with the machine selection, then the Choose Product Timeout option must be defined as zero.

Click the Payment section.
Set the Choose Product Timeout to 0 seconds.

This ensures no time restrictions for product selection during payment.

Pre-Selection – Always Idle

Pre-selection in Always Idle mode ensures the machine remains in a ready state for consumers. Use the following steps to configure:

For the configured machine, click the General tab.
Click the Card Readers section.
- Set the Card Reader MDB Level to 3.
- Set the Transaction Start Method to Product.
Click the MDB section.
- Set the MDB flags to Preselection Enabled.
- Set the MDB Level 3 Optional Features to Enable “Always
  Idle” state.

The Choose Product Timeout option is the timeframe that the consumer is required
to choose a product.
When the transaction flow is “Always Idle”, the Choose Product Timeout option
must be defined with a value greater than zero.

Click the Payment section.
Set the Choose Product Timeout desired value.

Pre-Authorization

Pre-Authorization allows the system to secure funds before the vending process begins. Follow these steps to set it up:

For the configured machine, click the General tab.
Click the MDB section.
Select the MDB flags to Flags Disabled.
The Choose Product Timeout option is the timeframe that the consumer is required
to choose a product.
When the transaction flow starts with card authorization, the Choose Product Timeout option must be defined with a value greater than zero.
Click the Payment section.
Set the desired Choose Product Timeout value.

The Default Credit option needs to be configured for Pre-authorization mode.
This is the amount Nayax will go for pre-authorization of the card.

Click the Payment section.
Set the desired Default Credit value.

📘
Decimal Alignment for Pre-Authorization Value
The pre-authorization amount must be consistent with the Decimal Place configuration in the system settings. Ensuring proper alignment prevents transaction errors and ensures smooth payment processing.

The Payment Flags option needs to be configured for Pre-authorization mode.

Click the Payment section.
Set the Payment Flags to no flags set.

Configure LCD Parameters

To optimize the user experience, configure the LCD messages displayed during idle or disabled states. This includes customizing or disabling the "Cash Only" or "Welcome" messages to suit your machine's requirements.

Cash Only Message for Amit and VPOS Devices

By default, the VPOS device displays a "Cash Only" message when it is disabled or in idle mode. This occurs when the Transaction Start Method is set to start with the machine. In the case of Marshall devices, this is the normal state. However, to ensure better communication, the "Cash Only" message should be customized.

Follow these steps to update the message:

Verify that the VPOS device is in idle mode or disabled.
Go to the Machine page.
Click the LCD section.
Enter an appropriate Cash Only Message that suits your needs.

Cash Only/Welcome Message for Touch Devices

When the Nayax Reader is disabled, the idle screen features animations instructing the consumer to choose a product or service first. Additionally, a "Welcome" message can be customized or disabled as needed.

Follow these steps to update the message:

Verify that the Nayax Reader is disabled and the idle screen displays the default animations.
To disable the Welcome message, send @@ to the device in the Welcome message attribute using the LCD section on the Machine page.
To customize the Welcome message, click on the LCD section and enter an appropriate message (for example, "Swipe card" to start the transaction).
Click Save to store the customized Welcome message.

Define the Prepaid Card(s) in the System

Define the Prepaid Test Card(s) sent to the customer under the Operator/Machine so the customer can immediately begin their proprietary integration tests.

Follow these steps to define the Prepaid Card(s):

Go to the Operator/Machine section in the system.
Define the Prepaid Test Card(s) that were sent to the customer.
Ensure the customer can begin their proprietary tests of the integration immediately.

📘
Customer Support Assistance
Should specific help be needed in this matter, please turn to Customer Support.