Payment Retry Configuration
Payment Retry Configuration
When a charge fails with a recoverable (retryable) error, instellix can automatically retry the payment according to a Retry Strategy that you configure per payment provider (Stripe or Adyen).
This reduces manual follow-up for temporary payment failures while keeping control over when and how often the next collection attempt runs.
Where to configure
Go to: Integration > Payment Providers > [Stripe | Adyen]
Open the Retry Strategy section for that provider.
Automatic retries apply only to retryable payment failures. Technical provider errors are handled separately by the platform and are not configured in this UI.
Enable retries
- Set the Retry Schedule switch to active.
- Choose a Retry Type.
- Enter the Retry Value.
- Enter Max Retry Attempts.
- Save the provider configuration.
Retry Type
| Retry Type | Meaning |
|---|---|
| Day of month | Retry on specific calendar day(s) of the month |
| Interval in days | Retry every n days after the failure |
| Interval in hours | Retry every n hours |
| Interval in minutes | Retry every n minutes |
Retry Value
- For Day of month: a day from
1to31. Multiple days can be specified as a comma-separated list (for example15,28). - For interval types: a positive number for the interval length.
If a configured day does not exist in a month (for example 31 in February), instellix uses the last valid day of that month.
Max Retry Attempts
Max Retry Attempts defines how many automatic retries are allowed after the initial failed charge.
Important: Day of month and Max Retry Attempts
For Day of month, each day in the list consumes one attempt — in the order you entered them.
Day of month needs matching Max Retry AttemptsIf you set Retry Type to Day of month, Retry Value to
15,28, and Max Retry Attempts to1, the payment is retried only on the 15th.To also retry on the 28th, set Max Retry Attempts to 2.
Rule of thumb: set Max Retry Attempts to at least the number of days in your Retry Value list.
Examples
| Retry Type | Retry Value | Max Retry Attempts | Result |
|---|---|---|---|
| Day of month | 15,28 | 1 | Retry on the 15th only |
| Day of month | 15,28 | 2 | Retry on the 15th, then on the 28th |
| Interval in days | 7 | 3 | Up to three retries, each 7 days apart |
| Interval in hours | 24 | 2 | Up to two retries, each 24 hours apart |
After the last attempt
When the final retry fails, the payment intent remains failed. Dunning then follows the document due date and your dunning configuration — not the retry schedule.
See Payment Terms and Dunning.
You can also trigger a manual retry for a failed payment intent via the Payment API or via the Webportal when needed.
Related articles
Updated 26 minutes ago