Orders
Maps the orders channel, checkout save behavior, order statuses, and which channel fields receive each saved value. Required before checkout can persist orders.
Tabs: General, Order Status, Order Data Fields, Shipping Fields, Billing Fields, Asynchronous Order Processing.
General
Channel
Orders channel link. Change via Set Channel if you have not configured one yet.
Save Orders
No: checkout completes but no order entry is created. Yes: each successful checkout creates an entry in the orders channel.
Orders Sequential Order Numbers
Yes: order/invoice numbers increment sequentially and are stored in the order entry title (not just entry ID). Reset by editing the title on the most recent order. No: numbering follows entry IDs only.
Orders Title Prefix / Suffix
Orders URL Title Prefix / Suffix
Prepended or appended to auto-generated order entry titles and URL titles.
Orders Convert Country Code
Yes: converts three-letter country codes submitted as country or shipping_country to full country names before save.
Last Order Number*
Required when sequential order numbers are enabled. Next order uses this value + 1.
Update Inventory When Editing Order
Yes: manually editing order line-item quantities, deleting line items, or deleting an order entry adjusts product inventory to match.
Order Status
Maps payment/checkout outcomes to channel entry statuses on the orders channel. Only matters if the channel uses custom statuses (e.g. paid, shipped).
| Field | When CartThrob sets it |
|---|---|
| Default Status | Successful completed order |
| Processing Status | In-process orders (PayPal Standard, offline payments, etc.) |
| Failed / Declined Status | Payment failed or declined |
| Pending / Expired / Canceled / Voided / Refunded / Reversed / Offsite | Matching gateway or Order Manager status transitions |
Order Data Fields
Each dropdown maps a checkout value to an orders channel field. All marked mappings are required to save.
| Field | Notes |
|---|---|
| Order Items | Serialized line-item data (entry_id, qty, title, options). See Order Items fieldtype. |
| Subtotal / Subtotal + Tax / Tax / Discount / Total | Cart totals at checkout |
| Transaction ID | Required for most gateway refunds via Order Manager |
| Card Type / Last Four Digits | Stored when gateway provides them |
| Coupon Codes | Applied coupon codes |
| Payment Gateway | Gateway short name used |
| Error Message | Gateway decline/failure message |
| Language | Customer language preference |
| Customer Name / Email | Required |
| Customer IP / Phone / Site ID | Optional audit fields |
| Subscription ID / Vault ID | Recurring or saved-payment references |
Shipping Fields
Maps shipping method, cost, and address components saved on the order entry. Shipping Option is the selected shipping plugin/method name.
Billing address fields: Shipping First/Last Name, Company, Address, Address2, City, State, Zip, Country, Country Code, Phone, Full Shipping Address (combined).
Billing Fields
Same pattern for billing: Full Billing Address, name, company, address lines, city, state, zip, country, Country Code.
Asynchronous Order Processing
Offline payments only. Queues order post-processing so heavy work does not block the checkout response.
| Option | Behavior |
|---|---|
| Disabled | Process immediately at checkout |
| HTTP | Process one queued job per incoming web request |
| Cron | Process via scheduled hit to the consume URL shown on this tab |
Worker Base URL — Override if the cron/HTTP worker must call a different site URL (multi-server setups).