Skip to main content
This endpoint requires HMAC-SHA256 authentication. See Authentication for signature computation details.

​
Endpoint Validation

When you create a webhook endpoint, the system sends a validation ping to verify that the URL is publicly accessible. The endpoint must:
  1. Use HTTPS protocol
  2. Be publicly reachable from the internet
  3. Respond with a 2xx status code to the ping request
If the validation ping fails, the endpoint will not be created. Ensure your URL is accessible before attempting to register it.

​
Endpoint Limits

Each group can configure up to 16 webhook endpoints. Attempting to create more will return an ENDPOINT_LIMIT_REACHED error.

​
Signing Secret

The response includes a secret field that is used to verify webhook signatures. This secret is only returned once during endpoint creation.
Store the webhook signing secret securely. You’ll need it to verify incoming webhook payloads. See Receiving Webhooks for signature verification details.

​
Event Types

Subscribe to one or more event types:
EventDescription
payment.completedPayment succeeded on the terminal
payment.failedPayment was declined or encountered an error
payment.cancelledUser cancelled the payment
payment.timeoutTerminal didn’t respond within 90 seconds