Subscription Events: Completed Line Items

When Pax8 emits subscription events, each event corresponds to a Completed Line Item—the atomic transaction that drives billing and provisioning. These events allow partners to automate workflows such as onboarding, billing updates, renewals, and cancellations.

Completed Line Items represent every transaction from subscriptions, arrears billing, and one-time charges. Each event includes a type field that identifies the nature of the change.

Line Item Types & What They Mean

Use these types to decide which events to subscribe to for automation:

• New – A new subscription was created (initial entitlement).
• Change – Mid-term modification (e.g., seat increase/decrease, price updates).
• ChangePartial – A partial product swap. Related to upgrades/downgrades.
• ChangeProduct – A product swap (old product credited, new product charged). Related to upgrades/downgrades.
• UpdateRatePlan – Rateplan change without altering the product.
• SpiffPriceAdjustment – A promotion or spiff adjustment applied to the line item.
• Renewal – A subscription commitment term was renewed.
• Cancel – A subscription was fully canceled.
• Resurrect – Reactivation of a previously canceled subscription.
• Migration – Migration of a subscription (e.g., between partners or companies).
• ParentReassignment – Ownership reassignment to a new parent subscription.
• TrialCreate – A trial subscription was created.
• TrialConvert – A trial converted to a paid subscription.
• TrialCancel – A trial was canceled.
• ArrearsUpload – Manual arrears line item (manual usage posting).
• RevertToCurrent – Reverts a pending change back to current state.