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

# TransactionNotify

`POST /TransactionNotify`

## Request body

- TransactionNotifyRequest, nullable — The request payload for the `TransactionNotify` endpoint, which provides final details of a charging session. This request is made after a session has been prepared and the charger is ready for use.
  - `HwSerial` string — The hardware serial number of the terminal.
  - `MachineId` integer — The ID of the vending machine or service device.
  - `NayaxTransactionId` integer — The unique Nayax internal transaction ID.
  - `SparkTransactionId` string, nullable — The unique ID generated in `StartAuthentication`.
  - `Amount` number, double — The final amount to charge in central currency units (e.g., dollars).
  - `CardLast4Digits` string — The last four digits of the card presented.
  - `CardHash` string — The one-way hash of the whole card number.
  - `CardUid` string, nullable — The UID of the card (for prepaid cards).
  - `ServiceStationNumber` string, nullable — The number identifying the service station.
  - `SiteId` integer — The identifier for the Spark site.
  - `MachineAuTime` string, nullable — The timestamp from the device in `yyyyMMddHHmmssSSS` format.

## Response `200`

Success. The transaction notification was received.

- TransactionNotifyResponse, nullable — The response payload from the integrator to the `TransactionNotify` request. This response confirms the session status and echoes key identifiers.
  - `NayaxTransactionId` integer — The Nayax internal unique identifier of the transaction, echoed from the request.
  - `SparkTransactionId` string, nullable — The unique session ID, echoed from the request.
  - `HwSerial` string — The unique hardware serial number of the terminal, echoed from the request.
  - `MachineId` integer — The unique ID of the machine, echoed from the request.
  - `SiteId` integer, nullable — The ID of the site where the transaction originated, echoed from the request.
  - `ServiceStationNumber` string, nullable — The identifier of the service station, echoed from the request.
  - `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)