Overview
Subscription renewals are recurring invoice payments created by Stripe after the initial subscription checkout. PayPress records successful renewal payments as new local orders when the relevant Stripe invoice events are received.
Requirements
- Active Stripe subscription.
- Working webhook connection.
- Invoice webhook events delivered to PayPress.
- Subscription ownership validation passing for the local installation.
Steps
- Customer starts a subscription through PayPress.
- Stripe creates future renewal invoices.
- Stripe attempts payment on the renewal invoice.
- Stripe sends invoice payment webhook events.
- PayPress creates a renewal order for the new invoice.
- Merchant reviews the renewal order in PayPress Orders.
Expected Result
Each successful renewal invoice should produce a local order tied to that invoice. The local subscription record should stay synchronized with Stripe status and renewal information.
Important Notes
Renewal orders depend on webhook delivery. PayPress does not create renewal orders on a timer. Stripe is responsible for billing the customer and sending the events.
Troubleshooting
If a renewal succeeds in Stripe but no PayPress order appears, check Event Timeline for invoice.payment_succeeded or invoice_payment.paid. If ownership validation rejects the event, confirm the subscription was created by the same PayPress installation or has correct ownership metadata.