DMSI Subscriptions Pro Feature

>

Automated payment failure handling is added by Subscriptions Pro. The core DDLS plugin detects failed payments and notifies admin, but does not automate retries, dunning, or suspension.

What Triggers the Flow #

The core DDLS plugin fires the dmsilm_subscription_payment_failed hook when a payment attempt fails. Subscriptions Pro listens to this hook and starts the automated recovery process.

The Recovery Window #

All durations are configurable. The default recovery window is 44 days from first failure to auto-cancellation.

Step-by-Step #

Day 0 — Payment Fails:

1. Core fires dmsilm_subscription_payment_failed
2. Subscriptions Pro starts retry schedule (days 1, 3, 5, 7)
3. Subscriptions Pro starts dunning sequence (email 1 sent immediately)
4. Grace period begins (14-day countdown)

Days 1–7 — Retry Period:

• Automated retries attempt to charge the customer’s saved payment method
• Dunning emails continue on their schedule
• Customer receives email notifications

Day 14 — Grace Period Expires:

• If no payment recovered: subscription moves to suspended
• Admin notification sent
• Suspension email sent to customer

Days 14–44 — Suspended:

• Auto-cancel countdown running
• No more retries or dunning emails
• Customer can still pay manually and be restored

Day 44 — Auto-Cancellation:

• Subscription cancelled automatically
• Win-back campaign starts

Recovery at Any Point #

If a payment succeeds at any point during the flow:

1. All pending retries are cancelled
2. All scheduled dunning emails are cancelled
3. Suspension is lifted (subscription returns to active)
4. Recovery is attributed to the dunning email if the customer clicked through one
5. Status history records the recovery