> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

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](https://devzone.nayax.com/docs/get-started/mcp-setup.md)**
>
> 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](https://devzone.nayax.com/docs/integrate-pos-device/spark/spark-integration)**
>
> Connect your backend to Nayax's payment terminals through Spark's API-driven workflows.

> **[Network requirements](https://devzone.nayax.com/docs/integrate-pos-device/spark/spark-network-requirement.md)**
>
> Set up HTTPS with TLS 1.2 or 1.3 and whitelist the required IPs.

> **[Security & authentication](https://devzone.nayax.com/docs/integrate-pos-device/spark/security-authentication/index)**
>
> Complete Spark's two-part authentication process to secure every transaction.

## Build your integration

> **[Payment flows](https://devzone.nayax.com/docs/integrate-pos-device/spark/payment-flows/transaction-flows-spark)**
>
> Choose the payment flow that matches how you initiate transactions.

> **[Webhook callbacks](https://devzone.nayax.com/docs/integrate-pos-device/spark/webhook-callbacks/index)**
>
> Use webhooks so Spark alerts your system to important events automatically.

## Reference & resources

> **[Spark API reference](https://devzone.nayax.com/reference/integrate-pos-device/spark/overview#)**
>
> Browse the full Spark API reference for every endpoint and parameter.

> **[Sample codes](https://devzone.nayax.com/docs/integrate-pos-device/spark/sample-codes/spark-authentication-code-sample.md)**
>
> Follow a full sample code flow for Spark's authentication mechanism.

> **[Additional resources](https://devzone.nayax.com/docs/integrate-pos-device/spark/additional-resources/index)**
>
> Find technical reference data and troubleshooting help for your Spark integration.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.