Skip to main content
POST
/
TimeoutCallback
TimeoutCallback
curl --request POST \
  --url https://{domain}/api/TimeoutCallback \
  --header 'Content-Type: application/json' \
  --data '
{
  "TerminalId": "0434334921100366",
  "MachineId": 71234996,
  "HwSerial": "0434334921100366",
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c"
}
'
{
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
  "Status": {
    "Verdict": "Approved",
    "ErrorDescription": "No Errors"
  }
}
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