Skip to main content
TransactionNotify
The TransactionNotify endpoint is used to notify the integrator about the final details of a charging session, including charger availability, amount, and display information.

Body

application/json

The request payload containing final session details.

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<int64>

The ID of the vending machine or service device.

NayaxTransactionId
integer<int64>

The unique Nayax internal transaction ID.

SparkTransactionId
string | null

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 | null

The UID of the card (for prepaid cards).

ServiceStationNumber
string | null

The number identifying the service station.

SiteId
integer<int16>

The identifier for the Spark site.

MachineAuTime
string | null

The timestamp from the device in yyyyMMddHHmmssSSS format.

Response

200 - application/json
object | null

Success. The transaction notification was received.

The response payload from the integrator to the TransactionNotify request. This response confirms the session status and echoes key identifiers.

NayaxTransactionId
integer<int64>

The Nayax internal unique identifier of the transaction, echoed from the request.

SparkTransactionId
string | null

The unique session ID, echoed from the request.

HwSerial
string

The unique hardware serial number of the terminal, echoed from the request.

MachineId
integer<int64>

The unique ID of the machine, echoed from the request.

SiteId
integer<int16> | null

The ID of the site where the transaction originated, echoed from the request.

ServiceStationNumber
string | null

The identifier of the service station, echoed from the request.

Status
object

An object confirming how to proceed. The Verdict is typically "Approved" or "Declined".