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

# Set Partner Webhook URL

> Set (or clear) the webhook URL that receives partner fund balance change events.

Set or clear the partner-level webhook URL that receives [`pay.partner.fund-balance-changed`](/guides/webhooks/balance-change-webhook) events. Whenever the partner's prefund balance changes due to a deposit, withdrawal, or compensation, Holdstation Pay sends a `POST` request to this URL.

Pass an empty string `""` as `webhook_url` to disable notifications.

<Note>
  This endpoint configures the destination for the **Balance Change Webhook** only. Order events (`pay.order.status-updated`) are delivered to the per-order `callback` field set when the order is created — see [Orders Webhook](/guides/webhooks/orders-webhook).
</Note>

## Authentication

<ParamField header="Partner-App-Key" type="string" required>
  Your partner app key.
</ParamField>

<ParamField header="X-HSPay-Signature" type="string" required>
  Base64-encoded Ed25519 signature of the sign data.
</ParamField>

<ParamField header="X-HSPay-Timestamp" type="string" required>
  Unix timestamp (seconds) of the request. Must be within 60 seconds of server time.
</ParamField>

## Body Parameters

<ParamField body="webhook_url" type="string" required>
  HTTPS URL to receive fund balance change events. Pass an empty string `""` to clear the webhook.
</ParamField>

<RequestExample>
  ```json Set theme={null}
  {
    "webhook_url": "https://yourapp.com/api/webhooks/fund-balance"
  }
  ```

  ```json Clear theme={null}
  {
    "webhook_url": ""
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "success",
    "data": {
      "webhook_url": "https://yourapp.com/api/webhooks/fund-balance"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": "invalid request",
    "error_code": "BAD_REQUEST",
    "message": "webhook_url must be a valid HTTPS URL"
  }
  ```
</ResponseExample>

## Event Delivery

See [Balance Change Webhook](/guides/webhooks/balance-change-webhook) for the headers, payload schema, `change_type` values, and signature verification.