Enabling and Disabling Billing Cycles

When a subscriber is suspended, all subscriber-owned catalog items might be suspended or canceled. Therefore, billing might be suspended. In these situations, you might want to disable the subscriber billing cycle.

Disabling billing cycles has the following consequences:
  • Recurring rating stops for the disabled billing cycles and any balance cycles aligned with the billing cycles.
  • The billing cycle definition cannot be changed.
  • The SubscriberQueryWallet and GroupQueryWallet SubMan APIs do not return billing cycle information.
  • Notification messages do not include billing cycle information.
  • The SubscriberEstimateRecurringCharge and GroupEstimateRecurringCharge SubMan API responses do not include balance impacts from recurring processing on disabled billing cycles and billing-cycle-aligned balance cycles.
  • A RecurringChargeNotification notification is not sent for disabled billing cycles and billing-cycle-aligned balance cycles.

You can disable billing cycles only if the wallet has an active billing cycle and the wallet has no postpaid main balances. If the wallet has a pending billing cycle change, the pending change is deleted when the billing cycles are disabled.

When billing cycles are enabled after being disabled, a billing cycle starts immediately and the current day becomes the first day of the billing cycle. For example, a subscriber has a monthly billing cycle starting on the 1st of the month, and this billing cycle is disabled on the 5th. On the 20th, the cycle is re-enabled. The subscriber now has a monthly billing cycle starting on the 20th. Periodic balances whose periods align with billing cycles are updated to follow the new billing cycle definition. However, no balance refund or forfeiture occurs due to the duration change of the current periods.

Use the BillingCycleDisabled field in the following SubMan APIs to disable or enable subscriber billing cycles:
  • SubscriberModify (PUT /subscriber)
  • GroupModify (PUT /group)

For information about cycle processing, see MATRIXX Pricing and Rating.

For information about specific SubMan APIs, see MATRIXX Subscriber Management API.