Security, Privacy, AI and CSR information for all Piano products now lives in one place. Explore our Compliance Center.
Subscriptions
English French
English French

How to detect if a renewal has failed?

To detect failed renewals you can use the following webhooks:

  1. grace_period_extension_on_renewal​ - when the grace period is configured

  2. subscription_auto_renewed_failure​ - when the grace period is not configured

More information about webhooks is available here.

Using Stripe Billing? If you process payments with Stripe, the grace period fields in webhooks carry different values. is_in_grace is true while Stripe retries the payment, grace_period_start_date is the start of the current billing period, and grace_period_length is the length of the current billing period.

If you don’t have webhooks enabled, from the Subscription report (log) you can search for users whose renewal failed via the filter Inactive → Payment failure.

Last updated: