Improved

Identify dunning status directly from order and subscription webhooks

You can now identify whether an order or subscription is in dunning directly from webhook payloads, without needing to cross-check separately.

What's new?

We’ve added new keys to our order and subscription webhook payload to make this information available.

For order webhooks, we’ve added the following keys in all order webhooks:

  • isDunning: Indicates whether the order has gone through a payment failure or not. true indicates the order has experienced at least one payment failure and is or was in dunning; false indicates the order was processed without any payment failure.
  • firstPaymentAttemptAt: The date and time of the first payment attempt for the order. This is useful for identifying when the initial payment attempt was made, especially when the order is in dunning

For subscription webhooks, we’ve added the following key in all subscription webhooks:

  • isBillingRetryOn: Indicates whether the subscription is currently in billing retry/dunning. true indicates the most recent order payment failed and the subscription is in billing retry/dunning; false indicates the most recent order payment was successful.

Refer to the Order entity documentation and Subscription entity documentation for more details