TimeoutCallback

📘

Pre-Authorization Only

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

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 CancelTransactionor Settlement are received.

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

🚧

Timed-out Session

Do 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 configuredTimeoutCallback endpoint. 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

FieldTypeRequiredDescription
TerminalIdStringYesIdentifier of the terminal that initiated the transaction.
MachineIdIntegerYesID of the vending machine or device.
HwSerialStringYesHardware serial number of the terminal.
SparkTransactionIdStringYesUnique Spark transaction identifier.

📘

Nayax Callback

This is a callback from Nayax, no response body is required. A simple 200 OK server acknowledgment is sufficient.