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

# Settlement

`POST /Settlement`

## Request body

- SettlementRequest, nullable — The request payload to finalize a pre-authorized transaction after the session ends and the final amount is known. This method is only relevant for transactions using the Pre-Authorization flow.
  - `NayaxTransactionId` integer — The unique transaction ID assigned by Nayax for the transaction being settled.
  - `SparkTransactionId` string, nullable — The unique session ID from the initial `/StartAuthentication` request. This ID links the settlement to the original transaction.
  - `SiteId` integer, nullable — The identifier of the site where the transaction occurred. This value is an echo from the initial authorization callback.
  - `TerminalId` string — The serial or external ID of the terminal used for the transaction.
  - `TerminalIdType` integer, nullable — Defines the ID type used for the `TerminalId`. Use `1` for the HW Serial and `2` for the Nayax Machine ID.
  - `Amount` number, double — The final transaction amount to be settled, specified in major currency units (e.g., dollars or euros).
  - `EReceiptData` string, nullable — An optional JSON-formatted string containing additional e-receipt details. This data can be used to provide digital receipts to consumers via the Nayax eReceipt platform.

## Response `200`

Success. The transaction has been successfully settled.

- SettlementResponse, nullable — The response payload returned by Spark upon a successful `Settlement` request. This payload includes final transaction details such as the settled amount, card information, and timestamps.
  - `SparkTransactionId` string, nullable — The unique ID used for this transaction session, which is an echo of the value sent in 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
  - `CardBrand` string, nullable — The brand of the card used for the transaction, such as `Visa` or `MasterCard`.
  - `CardLast4Digits` string, nullable — The last four digits of the payment card used.
  - `AuthCode` string, nullable — The authorization code returned by the payment provider for the transaction.
  - `MachineAuTime` string, nullable — The device timestamp at the moment of authorization, formatted as `yyyyMMddHHmmssSSS`.
  - `AuTime` string, nullable — The authorization server's timestamp.
  - `SeTime` string, nullable — The timestamp from the settlement server, formatted as `yyyyMMddHHmmssSSS`.
  - `CurrencyCode` string, nullable — The ISO currency code for the transaction, such as `EUR`.
  - `CurrencyNumeric` string, nullable — The ISO 4217 numeric currency code, such as `978` for EUR.
  - `FiscalRrn` string, nullable — The fiscal reference number for the transaction, used for receipt and audit purposes.
  - `NayaxRRN` string, nullable — The internal Nayax settlement reference number.
  - `Amount` number, double — The final settled amount, approved by the Payment Provider.

---

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