Overview
A failed renewal payment occurs when Stripe cannot collect payment for a subscription invoice. This can happen because the card is declined, expired, requires authentication, or is no longer available.
Requirements
- Stripe subscription.
- Renewal invoice attempt.
- Webhooks configured.
- Access to PayPress Orders, Subscriptions, and Diagnostics.
Steps
- Open PayPress Orders and Subscriptions.
- Look for open, unpaid, failed, or needs-payment-method statuses.
- Open the related Order Details page.
- Review the Stripe invoice reference.
- Ask the customer to update their payment method if needed.
- Use Retry Payment when eligible.
Expected Result
PayPress displays the failed or open billing state it receives from Stripe. The subscription may become past due depending on Stripe billing behavior and retry settings.
Important Notes
Stripe controls renewal retries and dunning behavior. PayPress can retry collection on an eligible invoice using the Retry Payment action, but it does not recreate the subscription or directly mark the invoice paid.
Troubleshooting
If a failed renewal does not appear, check invoice webhook events. If Retry Payment is unavailable, confirm the order has a valid invoice ID, amount remaining, subscription context, and a retryable Stripe invoice state.