Assist_Design/docs/how-it-works/subscriptions.md
barsa 7c929eb4dc Update Customer Portal Documentation and Remove Deprecated Files
- Streamlined the README.md for clarity and conciseness.
- Deleted outdated documentation files related to Freebit SIM management, SIM management API data flow, and various architectural guides to reduce clutter and improve maintainability.
- Updated the last modified date in the README to reflect the latest changes.
2025-12-23 15:43:36 +09:00

899 B

Subscriptions & Services

How active services are displayed and refreshed.

Data Source

  • Subscriptions (services/products) are read from WHMCS via the mapped client ID.
  • Statuses (Active, Pending, Suspended, Cancelled, Completed) come directly from WHMCS.

Freshness

  • Subscription list cached for 5 minutes; individual subscription cached for 10 minutes.
  • Cache is cleared when WHMCS signals a change (webhooks) or when we update profile/address data that could affect related services.

What you see

  • Service name, status, start date, amount, and currency as stored in WHMCS.
  • Subscriptions are also used in the dashboard stats (e.g., active count). Those stats refresh after cache invalidation.

If something goes wrong

  • Missing WHMCS mapping: we return a clear error instead of an empty list.
  • WHMCS unavailable: we show “try again later” and do not cache failures.