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

# StopCallback

`POST /StopCallback`

## Request body

- StopCallbackRequest, nullable — The request payload sent by Spark to an integrator's configured `StopCallback` endpoint to notify that a consumer has presented a card to stop an ongoing session. This is used to validate and match the card against an active session.
  - `StopSiteId` integer — The ID of the site where the session stop was triggered.
  - `MachineId` integer — The unique ID of the vending machine or device where the card was presented.
  - `HwSerial` string — The hardware serial number of the terminal.
  - `CardLast4Digits` string, nullable — The last four digits of the card used for the transaction.
  - `CardHash` string — The hashed value of the payment card presented.
  - `SparkTransactionId` string, nullable — The Spark transaction identifier of the original initiated session.
  - `NayaxTransactionId` integer, nullable — The unique Nayax transaction ID associated with the open session.
  - `CardUid` string, nullable — A unique identifier of the card, if available.
  - `MachineAuTime` string, nullable — The terminal's local timestamp in the format `yyyyMMddHHmmssSSS`.
  - `ServiceStationNumber` string, nullable — The identifier of the charging point or station used.

## Response `200`

Success. A simple 200 OK server acknowledgment is sufficient.

- StopCallbackOutcome, nullable — The response payload from the integrator to Nayax's `StopCallback`, acknowledging the request and providing a status.
  - `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
  - `SparkTransactionId` string, nullable — The unique identifier for the Spark transaction that was requested to be stopped.
  - `ServiceStationNumber` string, nullable — The number identifying the service station where the session stop was attempted. This value is provided by Nayax if the device is configured to support multiple service points.

---

[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)
