v1

latestOpenAPI 3.0.12026-07-26181265484.9 KB

Transactions

DeclineCallback

post/DeclineCallback

Request body

MachineIdinteger

The unique ID of the vending machine or terminal where the transaction occurred.

HwSerialstring

The serial number of the hardware terminal.

SparkTransactionIdstring nullable

The unique identifier of the failed Spark transaction. This ID is typically generated during the StartAuthentication process.

Example request

{
  "MachineId": 71234996,
  "HwSerial": "0434334921100366",
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
  "Status": {
    "Verdict": "Declined",
    "ErrorCode": 44,
    "ErrorDescription": "Timeout on POS Device"
  }
}

Response

Success. A simple 200 OK server acknowledgment is sufficient.

SparkTransactionIdstring nullable

The unique identifier for the failed Spark transaction session. This ID is initially generated during the StartAuthentication process and is used to track the session throughout its lifecycle.

Example response

{
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
  "Status": {
    "Verdict": "Declined",
    "ErrorCode": 44,
    "ErrorDescription": "Timeout on POS Device"
  }
}