Guide
Subscription Bundle Troubleshooting
Troubleshooting rules for fixed subscription bundle checkout, plan changes, proration, scheduled downgrades, payment recovery, and customer library states.
SoundSync
Troubleshooting matrix
Keep support answers aligned with platform behavior.
| Symptom | Current cause | Safe answer |
|---|---|---|
| Product checkout rejects a subscription cart | Use the wrong endpoint | Use POST /api/subscriptions/bundles/checkout for fixed bundles. |
| Monthly and annual products in one bundle | Mixed intervals are outside fixed bundle scope | Create separate monthly and yearly bundle versions. |
| Already subscribed customer wants bundle price | Customer already has active access | Use change-preview and change-confirm instead of duplicate checkout. |
| Upgrade requested | Higher bundle selected in change-plan flow | Show proration preview and confirm the immediate upgrade. |
| Downgrade requested | Lower bundle selected | Schedule the change for next renewal and keep current products until then. |
| Customer library shows conflicting states | Rendering bug | Render exactly one state: active, scheduled change, upgrade preview, payment recovery, cancellation, or processing. |
