Smart QR Mode

The Smart QR mode displays a QR code on the user's primary device (e.g., a desktop browser). The user scans the code with a mobile device to launch the IAB flow in their mobile browser. After completion, the status is reflected back on the primary device.

This behaviour is configured at the partner level via backend configs. To override the partner-level defaults for a specific session, pass the following parameters to the Initiate Flow API when generating the launch URL.

Configuration Parameters

ParameterTypeDefaultDescription
additionalDetails.allowQrbooleanfalseEnables the QR flow on devices without a camera
additionalDetails.forceQrbooleanfalseForces the QR flow on all devices, regardless of camera availability

Behaviour Reference

The combination of allowQr and forceQr determines when the QR screen is shown:

additionalDetails.allowQradditionalDetails.forceQrBehaviour
falsefalseQR flow is disabled
falsetrueQR flow is launched always
truefalse
  • If the device has a camera, the user is redirected to actual flow without showing the QR screen.
  • If the device doesn't have a camera, the QR screen is shown.
truetrueQR flow is launched always