Maxio Subscriptions progress through various subscription states—from trialing to active, past due, unpaid, or canceled—based on billing events and customer actions. Understanding these states and how they transition ensures accurate revenue tracking and timely customer management.
Subscription State Definitions
Live States
| State | Description |
| active |
The subscription is paid, current, and not in a trial. This is the standard live state with no conditions. |
| trialing |
The subscription is within a valid trial period. It may transition to |
| past_due | A payment failure has occurred. If automated dunning is enabled, the dunning process begins. Otherwise, prompt the customer to update payment information. |
Inactive States
| State | Description |
| canceled |
The subscription is canceled—either manually or after the dunning process concludes without payment. Billing and collections stop immediately. |
| expired | The subscription has reached its configured term end date. |
| trial_ended | The subscription trial ended and the subscription is inactive. |
| on_hold |
Billing is temporarily paused. The subscription can later return to |
| unpaid | The subscription was marked unpaid after dunning. Charges accrue, but collections pause. You must collect or adjust the balance. |
| awaiting_signup | The subscription was created, but the signup is incomplete. |
| awaiting_signup_date | The subscription has a future signup date and has not started. |
Administrative States
| State | Description |
| pending | A transient internal state indicating the subscription is being created. |
| assessing | A transient internal state indicating periodic assessment. |
| paused |
Your Maxio account is suspended. |
| soft_failure | A transient failure occurred (e.g., gateway timeout). Retries are automatic. |
|
failed_to_create |
Signup failed due to a validation error or gateway issue. |
State Transitions
State transitions typically occur in response to signups, trials, payments, or expirations. Manual intervention is occasionally required, as outlined in the examples below.
Expired to Active
Scenario: A subscription has expired. To reactivate it, you must first cancel the subscription. Then, reactivate it.
Changing the product for an expired subscription does not re-activate it. The subscription remains expired.
Past Due to Active
Scenario: A payment failed and the subscription is past_due. If payment succeeds upon retry, the subscription becomes active.
Past Due to Trialing
Scenario: A subscription completes its trial period and then becomes Past Due because payment was expected but failed. To extend the trial:
First, cancel the subscription using the Cancel Immediately option. Then, reactivate it and include the trial. The balance will reset by default, but you may opt out of resetting.
If needed, change the next billing date to automatically adjust the trial end date.
Trial Ended to Active
Scenario: A no-obligation trial ended without a card on file. To proceed, reactivate the subscription. It will move to active.
Unpaid to Active
Scenario: The subscription is unpaid after dunning. To reactivate:
- Click "Retry/Reactivate" to collect payment.
- If that fails or you wish to waive the balance, click "Reset to $0".
Either action returns the subscription to active.
Suspended to Active
Scenario: A prepaid subscription has used all its balance and is suspended. To reactivate, add a prepayment covering the overage. The subscription becomes active once the balance is sufficient.
Troubleshooting
Missing Actions Menu Option in Subscription Summary
If you’re missing an option under the Actions menu in Subscription Summary, it may be due to the current subscription state. For full functionality, reactivation is required for inactive states like Trial Ended, Canceled, or Expired.
The options under the Actions drop-down vary by subscription state.
Subscription is Stuck in Pending or Assessing
If a subscription stays in pending or assessing longer than expected, please open a support ticket.
Comments
Article is closed for comments.