How to Configure Marshall BASIC Templates on VPOS Media 4 Mini

Configure Marshall protocol settings for VPOS Media 4 and Media 4 Mini in Nayax Core. Compare Always Idle Pre-Selection and Multi-Session Pre-Selection BASIC templates with side-by-side settings, best practices, and FAQs for Marshall VMC setup.

General

 

Nayax Core › VPOS Media Configurations

How to Configure Marshall BASIC Templates on VPOS Media 4 Mini

Configure the Marshall protocol on a VPOS Media 4 Mini device in Nayax Core by applying the BASIC template that matches your machine's transaction flow, Always Idle or Multi-Session.

👤 Operators - Vending, EV & Unattended Retail
📦 Nayax Core · VPOS Media 4 Mini
Prerequisites

Before You Start

  • Your machine is a VPOS Media 4 Mini. Marshall is not available on VPOS Media 4 or other devices in the VPOS Media family.
  • You have Operations > Machines access in Nayax Core.
  • You know whether your machine needs Always Idle Pre-Selection (standard vending) or Multi-Session Pre-Selection (variable-cost services like EV chargers or locker rentals). See Part 1 to decide.
ℹ️
What is the Marshall protocol? Marshall enables advanced communication between your VPOS Media device and the vending machine controller (VMC). It supports Always Idle product browsing (the customer selects before paying) and Multi-Session authorization with delayed settlement (the card is authorized upfront and the final charge is settled when the service ends). The Cashless MDB Address must be set to Marshall VMC for both templates.
💡
What is a BASIC template? A BASIC template gives you a pre-configured starting point instead of building your configuration from scratch. Entering the template tag auto-populates the essential fields in the Default Configuration tab with the recommended structure for your chosen mode. You then set the value for each parameter and add any additional attributes your machine requires.
Part 1

Choose & Apply a Template

  1.  

    In Nayax Core, go to Operations > Machines and locate your VPOS Media 4 Mini machine.

  2.  

    Open the General tab and decide which Marshall template matches your machine, then enter its template tag. See the two options below.

    Which Marshall Template Do You Need?

    Expand the option that matches how your machine handles payment.

    Standard Vending Always Idle Pre-Selection +
    MDB Level 3 Always Idle Marshall VMC

    Browse first, pay second - standard Marshall vending.

    The device stays in an always-idle state, enabling a retail-like browsing experience. The customer selects a product on the machine first, then pays. The transaction settles immediately.

    Template Tag VPOSM Marshall Pre-Sel Basic
    ⚠️
    Tag mismatch to confirm: Another Nayax U article and a confirmed Nayax Core screenshot both list this template as VPOSM MarshallAlwaysIdle Basic, not VPOSM Marshall Pre-Sel Basic. Please confirm the correct tag before publishing.

    Related guide: How to Set Up Marshall Always Idle Pre-Selection | VPOS Media

    Variable-Cost Services Multi-Session Pre-Selection +
    MDB Level 1 Multi-Session Marshall VMC

    Authorize upfront, settle when the service ends.

    For variable-cost services like EV chargers or locker and cart rentals. A single payment session handles authorization upfront, with final settlement occurring when the service ends - anywhere from 1 minute to several hours later.

    Template Tag VPOSM Marshall Multi Ses Basic
    ℹ️
    Session Time Out = 60 governs the keep-alive interval between the device and controller, not the maximum service duration. The peripheral device controls the actual session duration, up to 71 hours.
Part 2

Compare Settings & Save

These attributes control the Marshall behavior for each mode. Values shown are Nayax recommended defaults.

Nayax Core Field Always Idle Pre-Selection Multi-Session Pre-Selection
Card Readers
* Card Reader MDB Level 3 1
Decimal Place 2 2
EMV Contactless Transaction Limit Operator Sets Operator Sets
* Transaction Start Method Product Mag+Contact+Contactless
Communication
Communication Mode MQTT Enabled MQTT Enabled
MDB
Cashless MDB Address Marshall VMC Marshall VMC
MDB Flags 02 Pre-selection Enabled 02 Pre-selection Enabled
* MDB Level 3 Optional Features Enable "Always Idle" state -
Payment
* Choose Product Timeout (sec) 40 0
Default Credit Operator SetsSet higher than most expensive product Operator SetsSet higher than most expensive product
* Present Card Timeout Operator Sets -
VMC
Marshall Keep Alive Intervals 1 1
* Session Time Out 1380 60

* = Differs between Marshall templates

⚠️
BASIC = minimum required fields. These templates contain only the essential configuration. You must add any additional attributes your machine requires. Default Credit must always be set - it pre-authorizes payment to cover purchases and prevents non-payment.
  1.  

    Set the value for each attribute in the Default Configuration tab using the table above, then select the checkbox next to each attribute you changed.

  2.  

    Click Save.

    ✅
    What you should see: Your configuration values are saved to the machine record, but not yet pushed to the device.
  3.  

    Click Actions > Update Queue to push the changes to your device.

Recommendations

Best Practices

DO

Set Cashless MDB Address to Marshall VMC. This is required for all Marshall protocol configurations.

DO

Set Marshall Keep Alive Intervals = 1 to maintain a stable connection between the VPOS Media device and the Marshall controller.

DO

Set Default Credit higher than the most expensive product on the machine. This pre-authorizes payment and prevents non-payment.

DO

For Multi-Session, confirm that Session Time Out = 60. The peripheral device controls the actual session duration, up to 71 hours - this value governs the keep-alive interval.

DON'T

Do not use VPN mode. VPOS Media supports MQTT connectivity only.

DON'T

Do not use "Accept All" as the transaction start method.

Outcome

Result

🎉
Your VPOS Media device is configured.

Once your selected Marshall BASIC template is applied and pushed via Update Queue, your VPOS Media device is ready to process transactions using your chosen Marshall protocol mode.

Nayax Core › Operations › Machines › [Your Machine] › General › Model Name › Default Configuration › Actions › Update Queue
Help

Troubleshooting

My changes aren't reflected on the device +
Confirm you selected the checkbox next to each attribute you changed, then clicked Actions > Update Queue. Configuration values are not pushed to the device until the queue update is sent.
The device isn't communicating after I applied a template +
Check that Communication Mode is set to MQTT Enabled and that Cashless MDB Address is set to Marshall VMC. VPOS Media supports MQTT connectivity only - VPN mode is not supported.
Transactions aren't completing as expected +
Verify Default Credit is set higher than your most expensive product and that the checkbox is selected to enable it. An unset or too-low Default Credit can prevent purchases from completing.
The Multi-Session session is dropping unexpectedly +
Confirm Marshall Keep Alive Intervals = 1 and Session Time Out = 60. Session Time Out governs the keep-alive interval, not the session duration. If drops persist, check the physical connection between the VPOS Media device and the Marshall VMC.
Nayax U  |  VPOS Media  |  Simplify Payments. Maximize Loyalty.

FAQ

FAQ

Did you find this article helpful?

Related articles

How to Set Up Marshall Multi‑Session with Pre‑selection | VPOS MediaQuick View Pulse Configuration | VPOS MediaActivation Process for the VPOS Media Payment DeviceHow to Configure MDB BASIC Templates on VPOS Media 4Default Machine Model | Nayax CoreHow to Configure Pulse BASIC Templates on VPOS MediaHow to Set Up "Push to Start" MDB Level 1 Pre-Selection | VPOS Media