Search

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Show an image on the terminal

Engage your shoppers by showing an ad or other image on the display of the payment terminal.

You can show an image on the display of your payment terminal, for example an advertisement, or a special offer that’s generated by the cash register. By showing an image, you can use your terminal to increase shopper loyalty, or for marketing purposes.

The image can be a PNG, JPEG, GIF, or BMP file that you convert to Base64.

A request to show an image doesn't time out. The terminal continues to show the image until you send another request. For example, a payment request, a request for a different image, or a request to show the standby screen.

Security

The terminal never runs or stores an image that it receives. The terminal only decodes the image, to be able to show it on the display.

Make a display request for an image

  1. Convert a PNG, JPEG, GIF, or BMP image file to Base64.

  2. Make a POST request to a Terminal API endpoint, specifying:

    • DisplayRequest.DisplayOutput : An array with one array item containing:

      Parameter Description
      Device CustomerDisplay
      InfoQualify Display
      OutputContent.OutputFormat MessageRef
      OutputContent.PredefinedContent.ReferenceID Image
      OutputContent.OutputText An array with a Text parameter containing the image as a Base64-encoded string.
    Display request for an image
    {
       "SaleToPOIRequest":{
          "MessageHeader":{
             "ProtocolVersion":"3.0",
             "MessageClass":"Device",
             "MessageCategory":"Display",
             "MessageType":"Request",
             "ServiceID":"043001",
             "SaleID":"POSSystemID12345",
             "POIID":"V400m-346403161"
          },
          "DisplayRequest":{
             "DisplayOutput":[
                {
                   "Device":"CustomerDisplay",
                   "InfoQualify":"Display",
                   "OutputContent":{
                      "OutputFormat":"MessageRef",
                      "PredefinedContent":{
                         "ReferenceID":"Image"
                      },
                      "OutputText":[
                         {
                            "Text":"iVBORw0KGgoAAAAN...AAASUVORK5CYII="
                         }
                      ]
                   }
                }
             ]
          }
       }
    }

    If an error occurs while decoding the image, the image won't be shown.
    If the request is successful, you receive a display response with:

    • OutputResult.Response.Result: Success
    Display response
    {
        "SaleToPOIResponse": {
            "DisplayResponse": {
                "OutputResult": [
                    {
                        "Device": "CustomerDisplay",
                        "InfoQualify": "Display",
                        "Response": {
                            "Result": "Success"
                        }
                    }
                ]
            },
            "MessageHeader": {...}
        }
    }

The image continues to be shown on the display until you send another request.

See also