Order Status | BigCommerce Developer Center

Lesson 12 of 26 · 15 min

Each order status represents a state in the order-fulfillment workflow.

When moving through order management, the order status is not automatically updated. This needs to be changed as needed. You can specify status_id, which will automatically set the corresponding status. When status_id is not specified, it will be automatically set to 1, which will set status to Pending.

The following statuses are of the paid type:

Status ID	Name	Description
0	Incomplete	An incomplete order happens when a shopper reached the payment page, but did not complete the transaction.
1	Pending	Customer started the checkout process, but did not complete it.
2	Shipped	Order has been shipped, but receipt has not been confirmed; seller has used the Ship Items action.
3	Partially shipped	Only some items in the order have been shipped, due to some products being pre-order only or other reasons.
4	Refunded	Seller has used the Refund action.
5	Cancelled	Seller has cancelled an order, due to a stock inconsistency or other reasons.
6	Declined	Seller has marked the order as declined for lack of manual payment, or other reasons.
7	Awaiting payment	Customer has completed checkout process, but payment has yet to be confirmed.
8	Awaiting pickup	Order has been pulled, and is awaiting customer pickup from a seller-specified location.
9	Awaiting shipment	Order has been pulled and packaged, and is awaiting collection from a shipping provider.
10	Completed	Client has paid for their digital product and their file(s) are available for download.
11	Awaiting fulfillment	Customer has completed the checkout process and payment has been confirmed.
12	Manual Verification Required	Order is on hold while some aspect needs to be manually confirmed.
13	Disputed	Customer has initiated a dispute resolution process for the PayPal transaction that paid for the order.
14	Partially refunded	Seller has partially refunded the order.

BigCommerce considers all statuses other than those above to be of the unpaid type, except Refunded, which is considered neither paid or unpaid. Setting orders to certain statuses triggers notification emails.

List Order Statuses

GET https://api.bigcommerce.com/stores/{{store_hash}}/v2/order_statuses

Custom Order Status

The order status label can be changed in the Control Panel. This does not change the underlying functionality. See our support article on Order Status.

Resources:

Order Statuses