The Retries and Dunning tabs control how the plugin responds to failed payments — the retry schedule, maximum attempts, and email campaign configuration.
📌 What This Extension Adds: All retry and dunning configuration options are provided by Subscriptions Pro. Core DDLS records payment failures but does not retry them or send dunning emails.
Retry Settings (Retries Tab) #
| Option Key | Default | Description |
|---|---|---|
dmsilm_sp_retry_schedule | [1, 3, 5, 7] | Array of days after initial failure to attempt payment retries |
dmsilm_sp_max_retries | 4 | Maximum number of retry attempts before giving up |
Modifying the Retry Schedule:
The retry schedule is an array of integers representing days after the initial payment failure. The default [1, 3, 5, 7] means the plugin will attempt retry on day 1, day 3, day 5, and day 7. You can customise this to any combination of days, for example [1, 2, 3, 5, 7, 14] for a more aggressive 6-attempt schedule.
Maximum Retries:
dmsilm_sp_max_retries should match the number of entries in dmsilm_sp_retry_schedule. If they differ, the plugin uses whichever limit is hit first.
Grace Period Settings (Grace Tab) #
| Option Key | Default | Description |
|---|---|---|
dmsilm_sp_grace_period_days | 14 | Days of grace period after initial payment failure |
dmsilm_sp_auto_cancel_days | 30 | Days after suspension before auto-cancel fires |
See Grace Periods and Suspension for detailed behaviour documentation.
Dunning Settings (Dunning Tab) #
The Dunning tab configures the timing of dunning emails relative to the retry schedule. The dunning sequence consists of 3 emails (see Dunning Email Campaigns).
| Setting | Description |
|---|---|
| Dunning Email 1 Timing | When to send the first dunning email (default: immediately on failure) |
| Dunning Email 2 Timing | When to send the second dunning email (default: after retry 2) |
| Dunning Email 3 Timing | When to send the final warning email (default: after retry 3) |
Email timing is configured as days after initial payment failure to align with retry attempts.