Understanding X-Cart Order Statuses
page last edited on 08 November 2017
Every order in your X-Cart store has a payment status and a fulfilment status. These two statuses provide information as to the current state of the order in the order processing workflow
By default, X-Cart uses the following order statuses:
|Q||Awaiting payment||The order has been created, but has not been paid yet. It is used as the initial status of all orders for which an offline payment method was selected (like Phone ordering, Wire Transfer, etc.) It may also be assigned as a temporary initial status to orders for which an online payment method was selected. In this case the Awaiting payment status indicates that the buyer has submitted their payment information, but the result of the transaction is not known yet: the order payment is neither successfully processed nor declined yet.|
|P||Paid||The buyer has been fully charged for their purchase. With online payment methods, this usually means that the money for the purchase has been transferred to the merchant’s account.|
|PP||Partially paid||The order has been partially paid (or there has been a partial refund).|
|A||Authorized||This status can only be set by a payment processor (cannot be set manually). It indicates that an authorization has been placed on the buyer’s card to ensure the buyer has sufficient credit or balance to pay for the purchase. The bank has put a hold on the requested amount, but the money has not been transferred to the merchant yet. The merchant has yet to place a charge to capture it.|
|D||Declined||This status can only be set by a payment processor (cannot be set manually). It indicates that an attempt to authorize or charge the buyer’s card has failed and the order has been cancelled.|
|C||Cancelled||The order has been cancelled by the merchant. Typically, an order has to be in the Authorized or Awaiting payment state before it becomes Cancelled.|
|R||Refunded||The money for the purchase has been refunded in full. This status can be set automatically by payment processors whose X-Cart integration supports refunds, or it can be set manually by administrator. Typically, an order has to be in the Paid state before it becomes Refunded.|
The statuses Awaiting payment, Paid and Authorized cause the inventory levels of the ordered items to be decreased according to the quantities ordered. The statuses Refunded, Cancelled and Declined cause the items to be restocked. The status Partially Paid does not affect the inventory.
|N||New||The initial status assigned by default to any new order once it has been created.|
|NB||New/Backorder*||The initial status assigned by default to any new order containing product(s) that obtained an out-of-stock status during the order placement. Can be assigned by the X-Cart system only.|
|P||Processing||The merchant is working on the order.|
|S||Shipped||The merchant has shipped the order.|
|D||Delivered||The buyer has received the package.|
|WND||Will not deliver||The order will not be shipped to the buyer for some reason.|
|R||Returned||The buyer is returning the ordered items; the items have been sent back to the merchant.|
|NF||Not Finished||(Enabled by the addon Not Finished Orders). After the buyer’s attempt to pay for the order, the payment system has returned the “cancelled” or “failed” callback, so the order payment status has been set to “Declined”.|
* The case occurs when the last item of a product (including products with PIN Codes) is ordered by 2 customers simultaneously. The order placed first according to the X-Cart order counting system is assigned the existing last item of the product. The order placed second - is assigned a backorder status for the product(s) that went out of stock during the order placement, a special notification on an order with a new/backorder status placed in the store being sent to the store admin. The “New/Backorder” fulfilment status is not displayed in a customer invoice, being substituted with the “New” status there. A store admin can either send a customer a notification that the backorder product will be delivered with a delay or make a partial refund for the out-of-stock items.
What you see in the first columns of the above tables is letter codes by which X-Cart’s system order statuses are represented in the software code; these codes are used internally only.
For information on custom order statuses, see the Managing X-Cart Order Statuses (X-Cart 5.2.7 and Later) section of this manual.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.