Skip to main content
POST
/
Cortina
/
{integratorName}
/
start
Cortina StaticQR Start
curl --request POST \
  --url https://lynx.nayax.com/payment/v2/transactions/Cortina/{integratorName}/start \
  --header 'Content-Type: application/*+json' \
  --data '
{
  "AppUserId": 111111,
  "Balance": 0,
  "SecretToken": "43262a8f8136f704b3d42b3f116e4bb0c4bf69e6d3415aff6e2cb9dfe06630ff",
  "TerminalId": 77788,
  "TransactionId": 12345678
}
'
{
  "Status": {
    "StatusMessage": "Cortina V2 Stub Tester",
    "Verdict": "Approved"
  }
}
Starts the transaction when a customer scans a static QR code. This endpoint notifies Nayax that a user is at the machine and ready to pay. It links the user ID to the machine ID using a secret token to begin the process.

Path Parameters

integratorName
string
required

Integrator name assigned by Nayax

Body

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
object[]
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

Success

Status
object

Transaction status