When you send a payment request or another request, the terminal generates notifications. These are JSON formatted webhooks that you can send to an endpoint on your POS system, to inform your staff of important events.
There are two types of terminal notifications:
- Display notifications give information about the progress of a transaction. For example, how the shopper is interacting with the terminal, or what the result of the payment is.
- Event notifications give information about the terminal's availability and state. For example, when a terminal is beginning maintenance, or shutting down.
If your integration uses asynchronous cloud communications, you must set up event notifications. We then send the Terminal API responses to your event notifications endpoint.
In addition to terminal notifications, you can get standard notifications. These notifications are generated on our platform and sent as HTPP callbacks (webhooks) to an endpoint on your server. There are several point-of-sale use cases that rely on standard notifications. For example, refunds, manual capture, and cross-channel shopper recognition.
If you want to receive display, event, or standard notifications, you need to set this up.