---
title: "Cortina StaticQR Start"
method: POST
path: "/Cortina/{integratorName}/start"
tags: ["StaticQR"]
---

# Cortina StaticQR Start

`POST /Cortina/{integratorName}/start`

## Request

- Base URL: `https://lynx.nayax.com/payment/v2/transactions`
- URL: `https://lynx.nayax.com/payment/v2/transactions/Cortina/{integratorName}/start`
- Auth: none required
- TypeScript: <https://skmtc.dev/nayax/apis/nayax-cortina-api/docs/Cortina/:integratorName/start/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `integratorName` string, required

## Request body

- StaticNotifyRequest
  - `AppUserId` string: - Mandatory - Length: 40 - Unique identifier of the consumer in Mobile App provider system
  - `Balance` number, double: - Optional - Decimal (max 3 digits for cents) - The balance of user's account.
  - `Data` string: - Data received from a third party and will be sent back in response
  - `Products` Product[]
    - `NayaxProductID` integer, nullable: The unique identifier for the product in the Nayax system.
    - `ProductGroupID` integer, nullable: The unique identifier of the product group to which the product belongs.
    - `ActorID` integer, nullable: The unique identifier of the actor associated with the product.
    - `ProductManufacturerID` integer, nullable: The unique identifier of the product's manufacturer.
    - `ProductName` string, nullable: The name of the product.
    - `ProductCatalogNumber` string, nullable: The catalog number assigned to the product.
    - `ProductBarcode` string, nullable: The barcode associated with the product.
    - `ProductPackageQuantity` integer, nullable: The quantity of product units per package.
    - `ProductDescription` string, nullable: A description of the product.
    - `ProductVolumeTypeID` integer, nullable: The volume type identifier associated with the product.
    - `DEXProductName` string, nullable: The name of the product in the DEX (Data Exchange) format.
    - `ProductCostPrice` number, double, nullable: The cost price of the product.
    - `ProductDefaultRetailPrice` number, double, nullable: The default retail price of the product.
    - `ProductMinimumPickQTY` integer, nullable: The minimum quantity of the product that can be picked.
    - `ProductStatus` integer, nullable: The status of the product, typically representing availability.
    - `ProductCashPrice` number, double, nullable: The price of the product when paid with cash.
    - `ProductCreditCardPrice` number, double, nullable: The price of the product when paid with a credit card.
    - `ProductPrepaidCardPrice` number, double, nullable: The price of the product when paid with a prepaid card.
    - `ProductExternalPrepaidCardPrice` number, double, nullable: The price of the product when paid with an external prepaid card.
    - `ProductMemberTypePriceBit` boolean, nullable: Indicates if the product has member-type-specific pricing.
    - `ProductPictureURL` string, nullable: The URL of the product's picture.
    - `CaloriesPer100g` number, double, nullable: The number of calories per 100 grams of the product.
    - `CaloriesPerServing` number, double, nullable: The number of calories per serving of the product.
    - `EANCode` string, nullable: The European Article Number (EAN) code associated with the product.
    - `ProductCreatedBy` integer, nullable: The identifier of the user who created the product entry.
    - `ProductCreationDate` string, date-time, nullable: The date and time when the product was created.
    - `ProductUpdatedBy` integer, nullable: The identifier of the user who last updated the product entry.
    - `ProductLastUpdated` string, date-time, nullable: The date and time when the product was last updated.
    - `VatId` integer, nullable: The VAT (Value Added Tax) identifier associated with the product.
    - `SequenceNumber` integer, nullable: The sequence number of the product.
    - `AgeVerificationEnableBit` boolean, nullable: Indicates whether age verification is required for this product.
    - `DepositTypeID` integer, nullable: The type of container for deposit/return schemes. Can be one of the following values: Plastic bottle - 90001, Can - 90002, Reusable Glass bottle - 90003.
    - `DepositFee` number, double, nullable: Deposit amount for bottle/can return schemes (max 100.00).
    - `DepositTax` number, double, nullable: Tax percentage applied to the deposit amount (0-100).
    - `Refs` object, nullable: A map of additional references related to the product.
  - `SecretToken` string: - Mandatory - Length: 64 - Unique key for the your system. This value will be Provided by Nayax in advance. You should keep this value as a secret in your system.
  - `TerminalId` string: - Conditional, must be sent if UniQR is not sent. - Length: 255 - Unique Identifier for the vending machine printed on a sticker or encoded in the QR (HW-Serial of the device)
  - `TransactionId` string: - Mandatory - Length: 40 - Unique identifier for the transaction which will be echoed in further requests and responses. Minimum of 8 chars.
  - `UniQR` string: - Conditional, must be sent if TerminalId is not sent. - Machine reference unique qr number

## Response `200`

Success

- StaticNotifyResponse
  - `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.dev/nayax/apis/nayax-cortina-api.md) - [All operations](https://skmtc.dev/nayax/apis/nayax-cortina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nayax/apis/nayax-cortina-api/revisions/421f6f83c257?raw)