start a static qr cashless transaction flow via the nayax cortina api for a kiosk or vending machine payment
domain: developerhub.nayax.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Complete the Cortina StartSession handshake first so you have a valid transaction ID and secret token
When a customer scans the machine's static QR code (or enters its terminal ID in your app), send a POST to /api/Cortina/{IntegratorName}/start with the transaction ID, AppUserID, TerminalId, and secret token
For the pre-selection flow, expect Nayax to call your Sale endpoint with the final amount once the customer picks a product, and respond with a sale success/failure
For the pre-authorization flow, expect a callback to your Authorization endpoint with a default hold amount before product selection, followed by a Settlement callback with the final amount
Acknowledge the final Sale End Notification callback so Nayax closes out the transaction on its side
Known gotchas
pre-selection and pre-authorization are two distinct certified flows with different callback sequences — don't mix their request/response shapes
if the machine fails to dispense or your Sale/Authorization response times out, Nayax automatically issues a Void (pre-selection) or Cancel (pre-authorization) — build idempotent handling for that on your side
the base domain and port for your /api/Cortina/... integrator endpoints is assigned per integrator during onboarding, not a single fixed Nayax hostname
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?