Order Payment Statuses in X-Cart

An overview of the default order payment statuses in X-Cart.

Olga Tereshina avatar
Written by Olga Tereshina
Updated over a week ago

Every order in your X-Cart store has a payment status. This status provides information as to the current state of the order in the order processing workflow.

By default, X-Cart uses the following order payment statuses:

  • Awaiting payment (Q*): 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 orders, 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.

  • Paid (P): 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.

  • Partially paid (PP): The order has been partially paid (or there has been a partial refund).

  • Authorized (A): This status can only be set by a payment processor (cannot be set manually). It indicates that 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.

  • Declined (D): 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 canceled.

  • Cancelled (C): The order has been canceled by the merchant. Typically, an order has to be in the Authorized or Awaiting payment state before it becomes Cancelled.

  • Refunded (R): 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 the administrator. Typically, an order has to be in the Paid state before it becomes Refunded.

* The letters in brackets are the code by which X-Cart stores order statuses in the software code; these codes are used internally only.

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.

Related pages:

Did this answer your question?