{"title":"Event notifications","category":"default","creationDate":1727766660,"content":"

From time to time, your payment terminal encounters an issue, or needs to perform maintenance. When this happens, the terminal generates an event notification. You can use event notifications in your POS app to inform your staff of the terminal's availability and state.<\/p>\n

\n

If your integration uses asynchronous cloud communications<\/a>, you must set up event notifications. We then send the Terminal API responses to your endpoint.<\/p>\n<\/div>\n

Here we describe how to set up event notifications. You can do this in your Customer Area<\/a> or by using API calls<\/a>. You then receive webhooks that include a Terminal API \n EventNotification<\/code>\n<\/a> and, if applicable, a Terminal API asynchronous SaleToPOIResponse<\/code><\/a>. You can use the received information to show a message in your POS app.<\/p>\n

Set up event notifications in the Customer Area<\/h2>\n

To get event notifications and, if applicable, asynchronous Terminal API responses, you need to make sure you can receive HTTP callbacks (webhooks) on a specific endpoint. Then you need to provide the URL to that endpoint in your Customer Area. Make sure to acknowledge<\/a> that your POS system successfully received an event notification from the terminal.<\/p>\n

    \n
  1. \n

    Prepare your system. It needs to have:<\/p>\n