Skip to main content
Spark is Nayax’s server-to-server API, enabling third-party systems to initiate and manage payment transactions on Nayax terminals remotely. It is designed for use cases where direct communication with the terminal, such as through Marshall, is not possible or desired, or as remote-controlled electric vehicle (EV) chargers, intelligent vending machines, or connected kiosks. Spark enables developers to initiate a session, handle authentication, authorize payments, and trigger settlements, all from their backend system. At the same time, Nayax manages the actual card interactions through its POS devices, such as VPOS Touch. Spark allows you to:
  • Control terminals remotely over the internet.
  • Offer flexible user experiences: remote commands, self-managed loyalty cards, and dynamic pricing.
  • Retain control over the business logic while Nayax handles the payment processing and compliance.

Set Up the MCP Server

Connect your AI assistant to Nayax documentation for instant answers.

​
Remote and device start

As an integrator, you’ll utilize the Spark API to manage distinct transaction flows, initiating sessions either remotely or directly from the device.
  • With Remote Start, your server initiates the transaction by requesting that Nayax activate a specific device, a flow beneficial for app/computer-driven transactions.
  • With Device Start the transaction process begins directly from Nayax’s terminal when a consumer interacts with it, allowing you to display crucial information, such as tariffs or service station availability, to the user via Nayax’s InfoQuery API method before the session even formally commences on the machine.
This distinction in initiation points is crucial for tailoring your integration to the specific user experience you aim to provide. This section provides guides to assist you in using the Spark API, outlining the integration process, authentication methods, available API methods, and other relevant information. See the pages below to learn more.

​
Get started

Integration

Connect your backend to Nayax’s payment terminals through Spark’s API-driven workflows.

Network requirements

Set up HTTPS with TLS 1.2 or 1.3 and whitelist the required IPs.

Security & authentication

Complete Spark’s two-part authentication process to secure every transaction.

​
Build your integration

Payment flows

Choose the payment flow that matches how you initiate transactions.

Webhook callbacks

Use webhooks so Spark alerts your system to important events automatically.

​
Reference & resources

Spark API reference

Browse the full Spark API reference for every endpoint and parameter.

Sample codes

Follow a full sample code flow for Spark’s authentication mechanism.

Additional resources

Find technical reference data and troubleshooting help for your Spark integration.