Webhook Payloads
Recovery
The payloads sent to your webhook endpoint when abandoned cart recovery or subscription dunning events occur.
Abandoned Cart Recovery Events
The following webhook events track the abandoned cart recovery lifecycle:Abandoned Checkout Payload Fields
The original payment that was abandoned. Use this to look up product, amount, and currency details.
Why the checkout was abandoned. One of:
payment_failed— Customer attempted payment but it failedcheckout_incomplete— Customer visited checkout but never attempted payment
Current lifecycle state of this recovery attempt. One of:
abandoned— Detected, no emails sent yetrecovering— At least one recovery email sentrecovered— Customer completed paymentexhausted— All emails sent or newer checkout foundopted_out— Customer unsubscribed
The payment ID of the successful recovery payment.
null until the checkout is recovered.Example: Handling ACR Webhooks
Dunning Events
The following webhook events track the subscription dunning lifecycle:Dunning Attempt Payload Fields
The subscription state that triggered dunning. One of:
on_hold— Renewals stopped due to payment failurepast_due— A renewal failed while a grace period is opencancelled— Customer cancelled from the customer portal
Current lifecycle state of this dunning attempt. One of:
recovering— Dunning emails are being sentrecovered— Customer updated payment method and payment succeededexhausted— All emails sent or subscription state changed
Example: Handling Dunning Webhooks
Abandoned Cart Recovery
Configure ACR email sequences and discount incentives.
Subscription Dunning
Configure dunning email sequences for lapsed subscriptions.
Subscription Webhooks
Related subscription lifecycle events like
subscription.on_hold and subscription.cancelled.Webhook Payload Schema
The schema below is the abandoned checkout payload (AbandonedCheckoutPayload). For the dunning payload fields, see Dunning Attempt Payload Fields.Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events
Last modified on September 25, 2026