{"title":"Show a QR code on the terminal","category":"default","creationDate":1776961627,"content":"

You can use the display of your payment terminal to show a QR code which the shopper can scan with their mobile device. The QR code can contain anything you like. For example, a URL to join your loyalty program or to download an app, a message with a link to a promotional offer, or an invitation to visit your webshop. You can also add a header and footer to explain what the QR code is for.<\/p>\n

\n

The terminal shows the QR code during the time you set in the request. If you do not set a time-out, the QR code continues to be shown until you send another request. For example, a payment request, or a request to show the standby screen<\/a>.<\/p>\n<\/div>\n

The following illustrations show a QR code with header and footer on a portrait, small portrait, and landscape display.<\/p>\n

\n
\n

\"\"<\/p>\n<\/div>\n

\n

\"\"<\/p>\n<\/div>\n<\/div>\n


<\/p>\n

\n

\"\"<\/p>\n<\/div>\n

Make a display request for a QR code<\/h2>\n
    \n
  1. \n

    If the QR code needs to contain more than just a URL, convert the content to a URL-encoded string. You'll need to specify the URL-encoded string in the display request, in the OutputContent.OutputBarcode.BarcodeValue<\/code>.<\/p>\n

    For example, if the QR code should have this content:<\/p>\n

    Visit www.adyen.com\/pos-payments and:\n- Learn about the features we support\n- Choose from a range of terminals<\/code><\/pre>\n
    The resulting URL-encoded string will look like this:<\/p>\n
    Visit%20www.adyen.com%2Fpos-payments%20and%3A%0A-%20Learn%20about%20the%20features%20we%20support%0A-%20Choose%20from%20a%20range%20of%20terminals<\/code><\/pre>\n
    If the QR code needs to contain only a URL, for example https:\/\/www.adyen.com\/pos-payments<\/code>, there is no need to URL-encode that. You'll specify the URL in the display request as a plain text string.<\/p>\n<\/li>\n
  2. \n
    Make a Terminal API<\/a> display request, specifying:<\/p>\n