---
title: "StartSession"
method: POST
path: "/StartSession"
tags: ["Transactions"]
---

# StartSession

`POST /StartSession`

## Request body

- StartSessionRequest, nullable — The request payload sent by the Spark platform to the integrator's configured `StartSession` endpoint to initiate a transaction session.
  - `HwSerial` string — The serial number of the payment terminal hardware.
  - `MachineId` integer — The unique identifier for the Nayax machine.
  - `TokenId` integer — A unique token provided by Nayax for secure authentication.
  - `Random` string — A random alphanumeric string used for session verification.

## Response `200`

Success. A new session has been successfully initiated.

- StartSessionResponse, nullable — The response payload from the `StartSession` endpoint, containing encrypted data and the session status.
  - `Cipher` string — The encrypted data used to authenticate and initiate the session.
  - `SparkTransactionId` string, nullable — The unique identifier for this transaction, which is echoed in all subsequent calls throughout the transaction's lifecycle.
  - `Status` Status — Transaction Status Details
    - `Verdict` string — Status of the request (Approved / Declined)
    - `ErrorCode` integer, nullable — - Conditional - Reason for declined request
    - `ErrorDescription` string, nullable — - Conditional - Length: 255 - Error description
    - `StatusMessage` string, nullable — - Optional - Length: 255 - Transaction status message as free text field

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/versions/421f6f83c257/schema)