TimeoutCallback

The TimeoutCallback API call notifies that the payment session has timed out due to inactivity or failure to complete the expected flow within a defined period. This callback is typically triggered when the user does not proceed with the session after a pre-authorization and no further actions, such as CancelTransaction or Settlement, are received.

Pre-Authorization OnlyThis method is only relevant for transactions with Pre-Authorization.

It serves as a final indication that the session should be considered terminated.

Timed-out SessionDo not attempt any further actions for the timed-out session. Use the SparkTransactionId to reconcile or log the timeout event.

Request

Spark sends a POST request to your configured TimeoutCallback endpoint: https://<YOUR_DOMAIN>/TimeoutCallback The request body is as in the example below:

{
  "TerminalId": "0434334921100366",
  "MachineId": 71234996,
  "HwSerial": "0434334921100366",
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c"
}

Request parameters

The table below describes the parameters of the request.

Field	Type	Required	Description
`TerminalId`	String	Yes	Identifier of the terminal that initiated the transaction.
`MachineId`	Integer	Yes	ID of the vending machine or device.
`HwSerial`	String	Yes	Hardware serial number of the terminal.
`SparkTransactionId`	String	Yes	Unique Spark transaction identifier.

Response

This is a callback from Nayax, so no response body is required. Return 200 OK to acknowledge it.

Spark Guides

API Reference

Request

Request parameters

Response

​Request

​Request parameters

​Response

Request

Request parameters

Response