Transactions

DeclineCallback

post/DeclineCallback

Request

Base URL
https://example.com:443
Auth
none required
TypeScript
https://skmtc.dev/nayax/apis/nayax-cortina-api/docs/DeclineCallback/post.ts
A function with typed inputs. Its response is checked against the schema.

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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.