Canceling Bundles

Bundles can be canceled at any time for a subscriber, group, or device and can be configured in My MATRIXX to trigger a cancelation notification. Product offers within a bundle cannot be canceled individually when purchased as part of a bundle. Only the product offer bundle can be canceled.

The cancelation policy in a bundle overrides the cancelation policy of individual product offers in the bundle. When a bundle is canceled, all product offers in the bundle are canceled.

If a bundle includes override cancelation price components for an offer, then the cancelation price components within the offer of the same type (charges, discounts, and grants) as the bundle price components are not applied. The bundle components are used instead (the bundle components supersede the offer components).

Note: If a bundle includes a cancelation override component for a product offer, it is applied even if the offer does not include a cancelation pricing component for the bundle component type.
If a bundle is configured with the expiration policy of Cancel in My MATRIXX, the offer expiration auto-triggers a cancelation with the applicable proration rules. The bundle expiration policy overrides the expiration policies of individual offers.
Important: A bundle cannot have an expiration policy of Cancel if it references an offer that contains a cancelation charge.
When purchasing and canceling catalog items using the SubMan APIs, the SubMan API responses and notifications include a list of updated balances with the following information:
  • Balance ID
  • Owner ID
  • Balance validity
  • Type of balance (main balance, actual currency balance, or cost balance)
  • Total updated amount
  • Current amount
  • A list of update amounts and the update types:
    • 1 — Charge
    • 2 — Discount
    • 3 — Grant
    • 4 — Adjustment
    • 5 — Cancellation Refund
    • 6 — Cancellation Forfeiture
    • 7 — Forfeiture
    • 8 — Usage Refund
    • 9 — Transfer To
    • 10 — Transfer From
    • 11 — Rollover To
    • 12 — Rollover From
    • 13 — Payment
    • 14 — Tax
    • 15 — Cancellation Tax Refund
    • 16 — Usage Tax Refund
    • 17 — Recharge
    • 18 — Payment Refund
    • 19 — Late Charge
    • 20 — Early Termination Charge
    • 21 — Write-Off
    • 22 — Finance
    • 23 — Debt Payment
    • 25 — Tax Payment
    • 26 — Payment Tax Refund
    • 27 — Tax Paid Previously

An in-cancelation status in MtxPurchasedOfferInfo indicates that an offer that is configured to end at the end of the current period has been canceled and is in the interval to end the period. If an offer is in a suspended state and it passes the provisioned end date, the offer state becomes inactive. Inactive indicates the offer end date has passed, either from cancelation or by setting the end date during provisioning.

To prevent bill shock, the PurchaseOffer and CancelOffer SubMan APIs can be called in advice mode (Advice of Charge) to estimate the cost of the purchase or cancelation. Response APIs describes the response SubMan APIs.
Table 1. Response APIs
Response Description
PurchaseOffer APIs When a PurchaseOffer SubMan API is called in advice mode, the response includes estimates for the purchase cost (charge and tax), any recurring charges, the amounts of granted assets, the cost of financing for a given down payment, including the principal amount financed, and the amount and number of installments in the finance contract offer.
CancelOffer APIs When a CancelOffer SubMan API is called in advice mode, the response includes estimates for the cancelation cost (charge and tax), the amount of the refund for any recurring charges, the amounts of forfeited assets, or the early termination charges in the finance contract.
Note: Detailed balance information is included in the notification when a balance is updated as the result of a bundle cancelation. For more information about notifications, see the discussion about notifications in MATRIXX Integration.

For more information about bundle properties, including the expiration policy, see My MATRIXX Help.

For information about canceling pre-active purchased items, see the discussion about pre-active purchased items in MATRIXX Subscriber Management.