Managing Subscriptions·3 min read
Failed Payments & Retry Settings
What happens when a charge fails, how to configure dunning, and how to recover revenue.
What happens when a payment fails
Expired cards and insufficient funds are normal in subscriptions — what matters is recovering them automatically. With retries enabled, a typical timeline looks like this:
- Day 0 — the scheduled charge fails. The contract shows under the Failed tab; the customer gets a "payment failed" email (if enabled) with a link to update their payment method.
- Day 1, 2, … — the app retries automatically per your settings, notifying the customer on each failed attempt. The final-attempt email tells them exactly what happens if it fails again.
- After the last retry — the app executes your chosen final action: skip the cycle, pause, or cancel the subscription.
If the customer fixes their card at any point, the next retry succeeds and the contract returns to normal.
Configuring retries
Go to Settings → Billing settings:
- Retry failed payments — the master toggle. Turn it on; without it a single card hiccup silently costs you the order.
- Maximum number of retry attempts — 1 to 6 (default 3).
- Delay before retrying — 1 to 10 days between attempts (default 1).
- Send an email if a billing retry attempt fails — keep on; the email contains the payment-update link, which is how most failures get fixed.
Recommended starting point: 3–4 attempts, 2–3 days apart — spans a payday cycle without dragging on for weeks.
Choosing the final action
| Action | What happens | Choose when… |
|---|---|---|
| Skip billing cycle (default) | The failed cycle is marked "Billing failed"; the next cycle proceeds as scheduled. | You'd rather keep the subscriber and lose one order. |
| Pause subscription | Billing stops until you or the customer resume. | You want an explicit re-engagement moment. |
| Cancel subscription | The contract ends. | You don't want unpaid contracts lingering. |
Recovering failed payments manually
Your recovery toolkit:
- Filter the subscription list by Failed to see every affected contract.
- On the contract, use Send link to update payment method — the customer fixes the card in one click.
- Once fixed, open Past Orders and click Rebill order on the failed cycle (each cycle shows its attempt count and last attempt date).
Still need help?
Our support team is available 24/7. Contact support →
