v1

latestOpenAPI 3.0.12026-07-26181265484.9 KB

Transactions

TimeoutCallback

post/TimeoutCallback

Request body

TerminalIdstring

The identifier of the terminal that initiated the transaction.

MachineIdinteger

The unique ID of the vending machine or device.

HwSerialstring

The hardware serial number of the terminal.

SparkTransactionIdstring nullable

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

Example request

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

Response

Success. A simple 200 OK server acknowledgment is sufficient.

SparkTransactionIdstring nullable

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

Example response

{
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
  "Status": {
    "Verdict": "Approved",
    "ErrorDescription": "No Errors"
  }
}