Skip to main content

​
Set up a webhook

1

Open Webhooks

Sign in to the merchant portal. At the bottom of the sidebar, open Developers, then select Webhooks.
2

Create a webhook

On the Summary tab, select Add Webhook.
3

Configure the endpoint

Fill in the webhook details:
  1. Enter your notification URL — the endpoint that will receive event payloads.
  2. Select the event types you want to subscribe to, or choose Subscribe to all events.
  3. Select Create to save the endpoint.
  4. Copy the signing secret from the confirmation dialog and store it securely. The secret is shown only once.
4

Whitelist UQPAY's IP addresses

To ensure webhooks are delivered successfully in your production environment, add UQPAY’s IP addresses to your server’s allowlist. See Webhooks Overview for the full list.

​
Check previous webhooks or re-trigger

You can review past webhook deliveries and resend them from the dashboard.
  1. On the Webhooks page, select the Events tab.
  2. Open a delivery to review its event ID, source ID, HTTP status, attempts, and request payload.
  3. Select Re-Trigger in the event details to resend the notification.

​
Edit or remove a webhook

From the Summary tab, open the row action menu to edit the endpoint, send a test event, rotate its signing secret, or delete the webhook.
Rotating the signing secret invalidates the current secret immediately. Update your receiving service with the new value before expecting further deliveries.
For signature verification, retry logic, and best practices, see Webhooks Overview.