> ## 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.

# Subscription Payload Reference

> JSON payload reference for subscription webhook events

JSON bodies delivered for subscription webhook events. For events, setup, and config vs wire naming, see [Subscription webhooks](https://dev.commerce.moonpay.com/reference/webhook/paylink-subscription/overview.md). See [Webhook request headers](https://dev.commerce.moonpay.com/reference/webhook/overview.md#webhook-request-headers) for delivery headers.

```json STARTED theme={null}
{
  "event": "STARTED",
  "subscriptionId": "65dc9f9f1154beaac39976c8",
  "subscriptionState": "NEW",
  "email": "test@example.com",
  "affiliateLink": "somecode",
  "nextChargeUrl": "https://app.hel.io/charge/7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "transaction": "...",
  "transactionObject": { "...": "..." }
}
```

```json RENEWED theme={null}
{
  "event": "RENEWED",
  "subscriptionId": "65dc9f9f1154beaac39976c8",
  "subscriptionState": "RENEWED",
  "email": "test@example.com",
  "nextChargeUrl": "https://app.hel.io/charge/7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "transaction": "...",
  "transactionObject": { "...": "..." }
}
```

```json ENDED theme={null}
{
  "event": "ENDED",
  "subscriptionId": "65dc9f9f1154beaac39976c8",
  "subscriptionState": "EXPIRED",
  "email": "test@example.com",
  "transaction": "...",
  "transactionObject": { "...": "..." }
}
```

```json SUBSCRIPTION_PENDING_PAYMENT theme={null}
{
  "event": "SUBSCRIPTION_PENDING_PAYMENT",
  "subscriptionId": "65dc9f9f1154beaac39976c8",
  "nextChargeUrl": "https://app.hel.io/charge/7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
  "transaction": "...",
  "transactionObject": { "...": "..." }
}
```

> [!NOTE]
>
> `nextChargeUrl` and `chargeToken` are omitted on `ENDED` events. `email` and `subscriptionState` are omitted on `SUBSCRIPTION_PENDING_PAYMENT`. Each payload includes `transaction` and `transactionObject` with the same shape as [Pay Link payload reference](https://dev.commerce.moonpay.com/reference/webhook/paylink-transaction/payloads.md).