C SDK Simulator - Nayax Developer Portal

The Nayax Marshall SDK includes a simulator to help developers test and debug their device integration with the Nayax payment system. The simulator replicates the behavior of the actual hardware and software interactions, allowing you to validate the vending process without needing physical hardware.

Simulator

When the C SDK simulator is started on a terminal, its menu will look like this: The table below describes each option on the simulator terminal.

Command	Description
`Start session 0`	Starts a session (a transaction) with product code 0.
`Close Session 0`	Only relevant in multisession. Closes the session (settles it) at the end of a transaction.
`Cancel Session`	Cancels the transaction from the peripheral’s end. Can be sent up until the consumer’s card has been approved.
`Query sessions`	Gives information about which sessions are currently open. This option is relevant from 4.0.0.22 and above.
`Reader state`	Gives information about whether the reader is `enabled (1)/disabled (0)`. This option is relevant from 4.0.0.22 and above.
`Link stats`	Provides information about the number of CRC errors, packet retransmissions, and communication losses.
`Quit`	Quits the simulator program.

Transaction Flow Examples

Below are examples of the flow for each transaction type:

Regular Transaction (Single Session):
1. Start a session: with [0]: Start session.
2. Present card, wait for authorization and “Thank you” screen.
Multi-Session Transaction:
1. Start a session with [0]: Start session 0.
2. Present card, wait for authorization and “Thank you” screen.
3. Close the relevant session- in this case, use [1]: Close Session 0.

See Also

C# SDK Simulator

Test and debug your C# SDK integration without physical hardware.

Java SDK Simulator

Test and debug your Java SDK integration without physical hardware.