Order and subscription statuses

In the AppDirect platform, subscriptions represent company entitlements to vendor products, and exist for as long as the company has access to a vendor product. Subscriptions consist of one or more orders, which create, modify, or terminate subscriptions. Orders essentially contain the context of operations that modify subscriptions. When a subscription is upgraded, the existing order is "finished" and a new order is created that contains the new cost, number of seats, and so on. Whenever a billing event occurs (free trial, discount, contract expiry, and so on), the order that contains it ends and a new one is created.

Subscription and order statuses are related but do not represent the same information. Subscriptions can contain multiple orders, and the orders in the subscription can have different statuses. For example, a subscription can have a status of Active and contain two orders: a one-time order (such as a setup fee) with a status of Finished, and a recurring order with a status of Active. Subscriptions are therefore active as long as the latest order in the subscription is also active.

Both order and subscription statuses are visible on the Orders page, although there is no "subscription" text to indicate the difference.

To view order and subscription statuses

📝 Note: This documentation page may refer to Manage > Marketplace in navigation steps. If the Manage option is not available in your navigation, click the grid icon on the top-left corner of your header and click Marketplace.

1. Go to one of the following pages, depending on the order and subscription statuses that you want to view:
   • To view statuses for all marketplace orders and subscriptions, go to Manage > Marketplace > Dashboard > Billing | Orders. The Orders page opens.
   • To view statuses for all orders and subscriptions for a specific user, go to Manage > Marketplace > Dashboard > Home | Users > user name, and scroll to the Orders table.
   • To view statuses for all orders and subscriptions for a specific company, go to Manage > Marketplace > Dashboard > Home | Companies > company name, and click the Billing tab. The Orders table appears.
     At the upper-right of the Orders table, there is a toggle between Products and Editions. By default, Products is selected, and the information on the page shows subscription summary information. When you click Editions, you can view order information.
2. Toggle the Products and Editions buttons as required to view subscription or order statuses in the orders table:
   • To view subscription status, click Products (selected by default). The Status column in the Orders table displays subscription status.
   • To view order status, click Editions. The Status column in the Orders table displays order status.

Order statuses

Orders can have any of the following statuses. The order status indicates whether the order generates fees that will be invoiced.

Status	Description
Active	Ongoing and generates fees.
Canceled	Canceled by or on behalf of the product owner, and does not generate fees anymore.
Failed	Could not be successfully activated. Does not generate fees.
Finished	No longer active. When a subscription is upgraded, a new order with an Active status is created, and the previous order changes to Finished. Certain settings, such as delayed downgrades, prevent orders from immediately changing to Finished and the new orders to Active. See Delayed downgrades. Depending on how metered usage is configured for your marketplace, and if metered usage is part of the subscription, metered usage orders might be generated each billing cycle. Each new metered usage order has an Active status, and the previous order changes to Finished.
Free trial	Free trial edition of the product that does not generate fees.
Free trial canceled	The free trial was canceled.
Free trial expired	The free trial has ended.
One time	Order is a one-time fee and only generates fees once.
Pending delayed provisioning	Provisioning is scheduled for a future date.
Pending customer approval	Indicates that the customer must approve the order, which occurs in assisted sales scenarios. When a reseller or sales agent creates a purchase for a customer, the customer receives an email that contains an approval link that redirects the customer to the checkout flow. The order remains in Pending customer approval status until the customer clicks the link and confirms the order in the checkout.
Pending remote creation	Appears during direct API interactions between the AppDirect platform and the vendor system, as described in Asynchronous user events. This status appears just before the AppDirect platform sends an event to the vendor, and remains until the vendor response is received, at which point the status changes accordingly, either to Pending async creation, Active or Free Trial (if a success response is returned), or Pending manual recovery (if a failure response is returned and the marketplace is configured for manual resolution of API errors).
Pending manual recovery	The Marketplace Manager must resolve an issue with the order. See View and resolve pending events.
Pending migration activation	Appears when you use bulk creation to upload externally created orders to the marketplace. See Migrate data. This status remains until the vendor returns a success or failure response.
Pending async creation	Appears in the following cases: The order was created for a Manual Web App product type, which requires the Marketplace Manager to resolve the order creation event. See View and resolve pending events. Interactions between the AppDirect platform and the vendor are being processed asynchronously. See Pending remote creation above.
Suspended	Appears in the following situations: There is an unpaid, overdue invoice. The end of the contract has been reached, the contract has not been renewed, and the end-of-contract grace period is in effect. If the grace period expires without renewal, the status changes to Canceled. The initial purchase payment failed. A sales agent manually suspended the order. The contract renewal failed.

Subscription statuses

Subscriptions can have any of the following statuses.

Status	Description
Active	Subscription is active.
Canceled	Subscription was canceled by or on behalf of the product owner.
Failed	Subscription provisioning failed and the subscription was never created.
Free trial	Subscription is active as a free trial.
Free trial expired	Subscription free trial has expired. The status changes either when you upgrade to a paid subscription (the status changes to Active) or the free trial grace period expires (the status changes to Canceled).
Initialized	Subscription activation is pending, either because provisioning is asynchronous or requires vendor or Marketplace Manager approval.
Suspended	Appears in the following situations: There is an unpaid, overdue invoice and the end of the grace period has been reached. The end of the contract has been reached, the contract has not been renewed, and the end-of-contract grace period is in effect. If the grace period expires without renewal, the status changes to Canceled. The initial purchase payment failed. A sales agent manually suspended the latest order. The contract renewal failed.