Guides

StaticQR

Suggest Edits

Static QR provides a straightforward and secure method for processing payments using wallet applications, enabling customers to scan a code displayed on a vending machine or terminal.

How it works

Before selecting a product, the user scans the QR code displayed on the machine, as in the image below.

Once scanned, the customer’s mobile device interacts with the payment system to process the transaction, providing a seamless payment experience without requiring additional hardware.

Transaction Flows

Cortina supports two types of StaticQR transaction flows:

  • Pre-selection
  • Pre-authorization

Learn more in the sections below.

Pre-selection

The Pre-selection flow simplifies the payment process by merging the steps of product/service selection and authorization into a single transaction. This flow is typically used for low-value or quick transactions, where the customer’s selection and payment authorization are handled together in one step.

See the diagram below:

Where:

  1. The process begins when the customer scans the QR code on the Nayax Device. This action triggers the Integrator to send a StaticQR Start request to the Cortina API, informing it of the incoming transaction.
  2. The Nayax Server sends a WakeUp Device Request to the Device and Vending Machine to initiate the transaction process.
  3. The Device approves the request and sends an Authorization Request to the Nayax Server, which begins the payment authorization process.
  4. The Nayax server requests authorization using the Cortina API StaticQR Sale endpoint.
  5. The Nayax Server receives the Response from the Integrator and returns it to the Device.
  6. If authorized, the Device begins the Vending Session, and the machine dispenses the product or service. The device sends the settlement command to the Nayax Server.
  7. The Nayax server forwards the Settlement Request to the integrator using Cortina's API Sale End Notification endpoint, with the final transaction amount to be settled.

This response is typically always approved in this flow, as the authorization has already been granted.

🚧

Void

In case the product fails to be dispensed to client, the Nayax Engine uses theStaticQR Cancel endpoind to void the payment request.

Pre-Authorization

The Pre-authorization Flow for Static QR involves several key steps to authenticate and authorize a payment using a static QR code. This flow ensures the transaction is valid before dispensing the product or service.

See the diagram below:

Where:

  1. The Integrator sends a StaticQR Start request to Nayax using Cortina API, informing it of the incoming transaction.
  2. The Nayax Server sends a WakeUp Device Request to the Device and Vending Machine to initiate the transaction process.
  3. The Device approves the request and sends an Authorization Request to the Nayax Server, which begins the payment authorization process.
  4. The Nayax server requests authorization using the Cortina API StaticQR Authorization endpoint.
  5. The Nayax Server receives the Response from the Integrator and returns it to the Device.
  6. If authorized, the Device begins the Vending Session, and the machine dispenses the product or service.
  7. The device sends the settlement command to the Nayax Server.
  8. The Nayax server forwards the Settlement Request to the integrator using Cortina's API StaticQR Settlement endpoint, with the final transaction amount to be settled.

🚧

Cancellation

In case the product fails to be dispensed to client, the Nayax Engine uses the StaticQR Cancel endpoint to cancel the Pre Authorization and the transaction.

Updated 7 days ago