---
title: "TransactionCallback"
method: POST
path: "/TransactionCallback"
tags: ["Transactions"]
---

# TransactionCallback

`POST /TransactionCallback`

## Request body

- TransactionCallbackRequest, nullable — The request payload sent by the Spark platform to the integrator's configured `TransactionCallback` endpoint. This request includes the full result of the card scan operation and is essential for proceeding with transaction confirmation or rejection handling.
  - `NayaxTransactionId` integer — The unique internal transaction ID assigned by Nayax.
  - `SparkTransactionId` string, nullable — The unique session ID generated in `StartAuthentication`.
  - `SiteId` integer — The ID of the vending site or Spark location.
  - `TerminalId` string — The unique ID of the terminal that read the card.
  - `MachineId` integer — The identifier of the vending machine or device.
  - `HwSerial` string — The hardware serial number of the terminal.
  - `MachineAuTime` string, nullable — The timestamp from the machine in the format `yyyyMMddHHmmssSSS`.
  - `AuthStatus` AuthStatus — The object containing the card authorization result.
    - `Verdict` string — The authorization decision, which can be `"Approved"`, `"Declined"`, etc.
    - `ErrorCode` integer — An optional numeric error code if the card was declined.
    - `ErrorDescription` string — An explanation of the error, if any.
    - `StatusMessage` string — A status message returned by Spark.
  - `CardLast4Digits` string, nullable — The last four digits of the presented card.
  - `CardHash` string — The one-way hash of the full card number.
  - `CardUid` string, nullable — The unique identifier of the card (for prepaid cards).
  - `Amount` number, double — The transaction amount in the main currency unit (decimal place 0, e.g., 15 for $15.00).

## Response `200`

Success. A simple 200 OK server acknowledgment is sufficient.

- TransactionCallbackOutcome, nullable — The response payload from the integrator to Nayax's `TransactionCallback`, confirming the receipt of the transaction result. This callback is triggered when a user presents a card and an authorization flow is initiated.
  - `SparkTransactionId` string, nullable — The unique identifier for the Spark session. This ID is generated during `StartAuthentication`.
  - `Status` Status — Transaction Status Details
    - `Verdict` string — Status of the request (Approved / Declined)
    - `ErrorCode` integer, nullable — - Conditional - Reason for declined request
    - `ErrorDescription` string, nullable — - Conditional - Length: 255 - Error description
    - `StatusMessage` string, nullable — - Optional - Length: 255 - Transaction status message as free text field

---

[API](https://skmtc.net/nayax/apis/nayax-cortina-api.md) · [All operations](https://skmtc.net/nayax/apis/nayax-cortina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nayax/nayax-cortina-api/versions/421f6f83c257/schema)