A common point of confusion is when a subscription remains Active while its related invoice shows Past Due. This behavior is typically controlled by your dunning configuration.
Key takeaway: Subscription state and invoice state are separate objects in Recurly and may not change simultaneously.
Why This Happens
- The invoice payment failed.
- Dunning retries are in progress.
- Your configuration is set to "Leave Subscription Active" at end of dunning.
Is This Expected?
Yes. During the retry window, the subscription often remains active to allow time for payment recovery.
When Does the Subscription Change State?
- If configured to expire at the end of dunning.
- If manually terminated by an admin or API call.
If your product access depends on invoice payment status, ensure your entitlement logic checks invoice state, not just subscription state.
Best Practices
- Align access control logic with billing lifecycle rules.
- Review Dunning settings to confirm intended subscription behavior.
- Train support teams to differentiate between invoice and subscription state.
Comments
0 comments
Article is closed for comments.