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

# Pay Link Payout Updated Webhooks

> Receive an opt-in webhook when the wallets a Pay Link pays out to change

## Pay Link payout updated webhook

`PAYLINK_PAYOUT_UPDATED` is sent when a Pay Link's payout changes: a recipient wallet, its currency or its source chain, or a split wallet's address or percentage while split payments are on. Use it to alert on unexpected changes to where your payments go.

A change that leaves the payout the same, such as renaming the Pay Link or reordering its recipients, does not send the event.

This is an opt-in **Pay Link webhook** event. Subscribing to `ALL`, `REGULAR_ALL`, or `REGULAR_TRANSACTION` does not include it.

### Subscribe

[Create a webhook](https://dev.commerce.moonpay.com/reference/webhook/create.md) with `PAYLINK_PAYOUT_UPDATED` in `optInEvents`:

```json theme={null}
{
  "name": "Payout changes",
  "targetUrl": "https://example.com/webhooks/helio",
  "paylinkId": "65dc9f9f1154beaac39976c8",
  "optInEvents": ["PAYLINK_PAYOUT_UPDATED"]
}
```

Include `paylinkId` for a specific Pay Link, or omit it for an account-wide subscription. The webhook also receives the payment events for its scope.

> [!NOTE]
>
> Opt-in events are set when the webhook is created. To add one to an existing webhook, contact support.

Standard [webhook authentication and signature verification](https://dev.commerce.moonpay.com/docs/webhooks.md#verifying-webhook-signatures) apply.

### Payload

```json theme={null}
{
  "event": "PAYLINK_PAYOUT_UPDATED",
  "paylinkId": "65dc9f9f1154beaac39976c8", // ID of the changed Pay Link
  "paylinkName": "Pro plan",
  "changedAt": "2026-11-16T10:00:00.000Z", // When the change was saved
  "changedBy": {
    "source": "API_KEY", // DASHBOARD, API_KEY or PLATFORM_PARTNER
    "apiKeyPrefix": "a1b2c3d4e5f6a7b8c9d0" // First 20 characters of the API key used
  },
  "previous": {
    "recipients": [
      {
        "currency": { "id": "6340313846e4f91b8abc519b", "symbol": "USDC" },
        "wallet": {
          "id": "667c1f9352919e4071561294",
          "name": "Treasury",
          "publicKey": "7YancRyNQyp9s6G7YNwx9H93UqswoKWqF9GuNJPufyvW",
          "blockchainEngine": { "id": "63b8c1e0f2a4b5c6d7e8f901", "type": "SOL" }
        }
      }
    ],
    "splitWallets": []
  },
  "current": {
    "recipients": [
      {
        "currency": { "id": "6340313846e4f91b8abc519b", "symbol": "USDC" },
        "wallet": {
          "id": "6912ab34cd56ef7890ab12cd",
          "name": "New treasury",
          "publicKey": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
          "blockchainEngine": { "id": "63b8c1e0f2a4b5c6d7e8f901", "type": "SOL" }
        }
      }
    ],
    "splitWallets": [{ "address": "4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T", "percent": 10 }]
  }
}
```

`previous` and `current` describe the payout before and after the change. `recipients` has the same shape as the recipients in the public Pay Link response (abbreviated above). `splitWallets` is empty while split payments are off.

`changedBy` says where the change came from:

| `source` | Meaning | Extra field |
| - | - | - |
| `DASHBOARD` | A team member in the dashboard | `userId` |
| `API_KEY` | A request made with your API key | `apiKeyPrefix`: the first 20 characters of the key, as the dashboard shows it |
| `PLATFORM_PARTNER` | A platform partner acting for your account | `platformPartner`: the partner, e.g. `MOONPAY` |

### Handling the event

* If you did not expect the change, check the Pay Link and your team access right away. A `previous` value tells you what to restore.
* Each change sends one event, so successive changes arrive as separate deliveries. Order them by `changedAt`.
