---
title: "subscription.past_due"
method: POST
path: "subscription.past_due"
---

# subscription.past_due

`POST subscription.past_due` (webhook)

Sent when a subscription payment fails and the subscription enters `past_due` status.

This is a recoverable state - the customer can update their payment method to restore the subscription.
Benefits may be revoked depending on the organization's grace period settings.

If payment retries are exhausted, a `subscription.revoked` event will be sent.

**Discord & Slack support:** Full

## Payload

- WebhookSubscriptionPastDuePayload — Sent when a subscription payment fails and the subscription enters `past_due` status. This is a recoverable state - the customer can update their payment method to restore the subscription. Benefits may be revoked depending on the organization's grace period settings. If payment retries are exhausted, a `subscription.revoked` event will be sent. **Discord & Slack support:** Full
  - `type` 'subscription.past_due', required
  - `timestamp` string, date-time, required
  - `data` Subscription, required — unresolved $ref

## Acknowledgement `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/77e4ef94fcc3/schema)