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

# TriggerTransaction

`POST /TriggerTransaction`

## Request body

- TriggerTransactionRequest, nullable — The request payload for the `/spark/TriggerTransaction` endpoint. This call initiates user interaction with a physical terminal and provides the necessary details for the transaction.
  - `SparkTransactionId` string, nullable — The unique session ID received from Spark during the `StartAuthentication` process.
  - `TerminalId` string — The unique ID of the target terminal.
  - `TerminalIdType` integer, nullable — Defines the ID type used for the `TerminalId`. Use `1` for the HW Serial or `2` for the Nayax Machine ID.
  - `Amount` number, double — The amount to be pre-authorized or charged for the transaction. This value is required for the Pre-Selection flow.
  - `PosDisplay` string, nullable — An optional custom message to show on the terminal's display.
  - `EReceiptData` string, nullable — Optional JSON-formatted string representing e-receipt details for machine operators who wish to provide digital receipts.
  - `TransactionTimeout` integer — The timeout in seconds for the terminal to wait for a card to be presented. This value must be greater than `0`.

## Response `200`

Success. The transaction was successfully triggered.

- TriggerTransactionResponse, nullable — The response payload from the `/spark/TriggerTransaction` endpoint, which confirms the result of the request to initiate user interaction with a physical terminal.
  - `SparkTransactionId` string, nullable — The unique transaction ID, 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)