> ## Documentation Index
> Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook Settings

> Configure webhook endpoints in the UQPAY dashboard to receive real-time event notifications.

## Set up a webhook

<Steps>
  <Step title="Go to Webhooks settings">
    Sign in to the dashboard, click your profile picture in the top-right corner, and select **Settings**. Then navigate to **Developer** → **Webhooks**.

    <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s1.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=ddd8f08750a81b96cbd11fae9c4cfefd" alt="Webhooks settings page" width="1352" height="878" data-path="images/account-center/webhooks-setting-s1.png" />
  </Step>

  <Step title="Create a webhook">
    Click **Create Webhook** in the top-right corner.

    <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s2.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=2ca197c620c84eecc99a0122c4a7c4b2" alt="Create Webhook button" width="1352" height="878" data-path="images/account-center/webhooks-setting-s2.png" />
  </Step>

  <Step title="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. Click **Create** to save.

           <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-ss3.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=3ae92a97e423a140539ff9b737f9ea2e" alt="Webhook configuration form" width="1352" height="878" data-path="images/account-center/webhooks-setting-ss3.png" />
  </Step>

  <Step title="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](/docs/account-center/v1.6/guide/webhooks-overview) for the full list.

    <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s4.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=5d77802d12b5bfe145425743e592e1bc" alt="IP allowlist reference" width="1352" height="878" data-path="images/account-center/webhooks-setting-s4.png" />
  </Step>
</Steps>

## Check previous webhooks or re-trigger

You can review past webhook deliveries and resend them from the dashboard.

1. On the Webhook page, select the **Events** tab.

   <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s10.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=a4b66b90889a76961097cd4c431ac76f" alt="Events tab" width="1352" height="878" data-path="images/account-center/webhooks-setting-s10.png" />

2. To view the details of a specific delivery, click the **...** menu next to the event and select **Details**.

   <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s11.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=2604986bd9632d3e45b2083836860d1a" alt="Event details menu" width="1352" height="878" data-path="images/account-center/webhooks-setting-s11.png" />

3. In the details panel, click **Re-Trigger** to resend the webhook notification.

   <img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s12.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=6d85b0031c2309ef37e5896843b59dd5" alt="Re-Trigger button" width="1352" height="878" data-path="images/account-center/webhooks-setting-s12.png" />

## Edit or remove a webhook

After a webhook is created, you can modify its URL or subscribed events, or delete it entirely, from the Webhooks list.

<img src="https://mintcdn.com/uqpay-ecc4f4d8/LSVZGfPa5IJvbfLG/images/account-center/webhooks-setting-s6.png?fit=max&auto=format&n=LSVZGfPa5IJvbfLG&q=85&s=ccce079976e30c6cda03c0f4798cb9d9" alt="Edit or remove webhook" width="1352" height="878" data-path="images/account-center/webhooks-setting-s6.png" />

## Related

For signature verification, retry logic, and best practices, see [Webhooks Overview](/docs/account-center/v1.6/guide/webhooks-overview).
