Dunning actions

Dunning is the process of retrying payment attempts and sending payment reminders to customers when a payment gets rejected. With Cleeng you can configure payment retries at intervals to ensure payment will be recovered and subscription can continue its cycles. Cleeng allows to setup retries and notifications in terms of subscription due to date, they can be set before and after up to what is your retries strategy. Cleeng as default gives you a smart retries setup that can guarantee an efficient recovery process.



If you use Cleeng Merchant, Dunning actions settings will be configured by Cleeng and they should remain default values, except otherwise agreed with your account manager.

If you operate for the web the Merchant of Record (hence, when you do NOT use Merchant), dunning actions settings are allowed to be adjusted the way you want.

Setup introduction

You can setup dunning actions based on the offer types your service provides. For each offer type configure payment attempts so as to receive events in provided timeframes. Your endpoint should listen to the subscriptionReadyForPaymentCapture or/and subscriptionReadyForPaymentAuthorisation event. To make sure it will be sent to a proper endpoint, please register in the Cleeng Webhooks Service.

Grace period

Grace period allows you to keep the subscription active after the subscription expiration date has been reached (even if a payment issue has ocurred). It gives an additional time to process payments or restore a cancelled subscription before it terminates.


Production change while the broadcaster has active subscribers!

When updating the dunning action settings in the production environment while the broadcaster has active subscribers, it's advised to turn off the new emails temporarily. Otherwise, the new dunning action settings updated on the production environment will trigger the system to send renewal emails to all subscribers including new and existing active subscribers.

Click Try It! to start a request and see the response here!