Skip to main content
TimeoutCallback
The TimeoutCallback API call notifies that the payment session has timed out due to inactivity or a failure to complete the expected flow within a defined period.

Body

application/json

The request payload containing details of the timed-out session.

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<int64>

The unique ID of the vending machine or device.

HwSerial
string

The hardware serial number of the terminal.

SparkTransactionId
string | null

The unique Spark transaction identifier for the timed-out session. This ID should be used to reconcile or log the timeout event.

Response

200 - application/json
object | null

Success. A simple 200 OK server acknowledgment is sufficient.

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 | null

The unique identifier for the Spark transaction that has timed out. This ID should be used to reconcile or log the timeout event.

Status
object

Transaction Status Details