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

# TimeoutCallback

`POST /TimeoutCallback`

## Request body

- TimeoutCallbackRequest, nullable — The request payload sent by Spark to a configured `TimeoutCallback` endpoint. This notification is sent when a payment session times out due to inactivity or failure to complete the flow within a set period.
  - `TerminalId` string — The identifier of the terminal that initiated the transaction.
  - `MachineId` integer — The unique ID of the vending machine or device.
  - `HwSerial` string — The hardware serial number of the terminal.
  - `SparkTransactionId` string, nullable — The unique Spark transaction identifier for the timed-out session. This ID should be used to reconcile or log the timeout event.

## Response `200`

Success. A simple 200 OK server acknowledgment is sufficient.

- TimeoutCallbackOutcome, nullable — The response payload from the integrator to Nayax's `TimeoutCallback`, confirming the receipt of the timeout notification. This callback signals that a pre-authorized payment session has timed out due to inactivity.
  - `SparkTransactionId` string, nullable — The unique identifier for the Spark transaction that has timed out. This ID should be used to reconcile or log the timeout event.
  - `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)