StopNotify

🚧

Enable StopNotify

This feature must be enabled in Nayax Core during the integration.

The StopNotify endpoint enables Spark to determine whether a card presented at the payment terminal while idle is authorized to stop an ongoing session. This is primarily used in Pre-Authorization flows, where the same card must be presented again to terminate the session and proceed to settlement.

Nayax will send the hashed card value and the last four digits captured earlier in the /TransactionCallback and /TransactionNotifyalong with terminal identifiers. Providers need to validate whether this card matches an ongoing session on that terminal. A matching card should result in an Approved response; otherwise, the Spark integrator should return a Declined verdict.

This feature must be enabled via Nayax Core. If no response is received from the Spark integrator within 5 seconds, the flow will be considered a failure from the consumer's perspective.

Request

Send a POST request to Spark/spark/CancelTransaction endpoint with the following body:

{
 "StopSiteId": 4,
 "MachineId": 71234996,
 "HwSerial": "0434334921100366",
 "CardLast4Digits": "1234",
 "CardHash": "7f2082ba5dbccf706b6987e75b62083f65b5695bc2d8c827c3e46769d007a9e6",
 "CardUid": "1288528281124927",
 "ServiceStationNumber": "5"
}

Request Parameters

The table below describes the parameters of the request:

Response

A successful response will return the following body:

{
  "SparkTransactionId": "12c7cec2-c690-4425-9a1f-db0db60e2d8c",
  "NayaxTransactionId": 2004545072,
  "SiteId": 2,
  "StopSiteId": 4,
  "MachineId": 71234996,
  "HwSerial": "0434334921100366",
  "MachineAuTime": "20240205194122328",
  "Status": {
    "Verdict": "Approved",
    "ErrorDescription": "No Errors"
  }
}

Response Parameters

The table below describes the parameters of the response: