--- title: "Order and checkout objects" source: https://support.storeconnect.com/articles/order-and-checkout-objects type: article format: markdown site: StoreConnect Support — product and developer documentation for StoreConnect site_index: https://storeconnect.com/llms.txt docs_index: https://support.storeconnect.com/llms.txt note: Append .md to any page or article URL on this site to get its Markdown form. --- # Order and checkout objects This is the largest domain in the schema, because it holds both sides of a purchase: the cart while a shopper is still deciding, and the order once they have paid. Use this article to find the object you need before you query or report on sales data. ## A cart becomes an order The single most useful thing to know is that **cart** and **order** are parallel structures, not one record changing state. A [Cart](cart-object-reference) holds [Cart Items](cart-item-object-reference). At checkout StoreConnect creates an [Order](order-object-reference) with [Order Items](orderitem-object-reference), and the cart is kept rather than deleted. So a completed purchase exists twice, and which one you query depends on the question: - **What is in progress, or was abandoned?** Query the cart. - **What was sold?** Query the order. Prices on an order item are what was actually charged, not what the price book says now. Fulfillment is decided on the cart, before the order exists. A [Cart Fulfillment](cart-fulfillment-object-reference) is one delivery method for part of the basket, and [Cart Fulfillment Item](cart-fulfillment-item-object-reference) assigns items to it. That is how one order ships some items and holds others for pickup. ## Money is separate from the order A [Payment](payment-object-reference) is one attempt to move money, so an order can have several: a failed attempt, a retry, a partial refund. The order's paid state is the sum of its payments rather than a field someone sets. [Payment Item](payment-item-object-reference) is the record that allocates part of a payment to a particular order or fulfillment, which matters when one payment covers a split shipment, or one order is paid by card and voucher together. :::note A [Payment Provider](payment-provider-object-reference) is the configured gateway. A [Payment Method](payment-method-object-reference) is what the shopper sees at checkout. One provider usually offers several methods, and surcharges are set on the method. ::: ## Two generations of promotions The schema carries both promotions models, which is the most common source of confusion here. [Promotion](promotion2-object-reference) (`s_c__Promotion2__c`) is the current model. Its [conditions](promotion2-condition-object-reference) say what a cart must satisfy, its [product scope](promotion2-product-scope-object-reference) limits what it applies to, and [usage](promotion2-usage-object-reference) records enforce limits. The objects labeled **Legacy Promotion** in the table below are the superseded model, kept so existing data still reads. Write against the current model. [Discount](discount-object-reference) is a different thing again: it reduces a price automatically, with no code entered. ## Objects in this domain | Object | API name | Purpose | |--------|----------|---------| | [Cart](cart-object-reference) | `s_c__Cart__c` | An in-progress basket. Becomes an order at checkout, and is kept afterwards | | [Cart Item](cart-item-object-reference) | `s_c__Cart_Item__c` | One product and quantity in a cart | | [Cart Fulfillment](cart-fulfillment-object-reference) | `s_c__Cart_Fulfillment__c` | How one part of a cart will be delivered: shipped, picked up, or collected | | [Cart Fulfillment Item](cart-fulfillment-item-object-reference) | `s_c__Cart_Fulfillment_Item__c` | Assigns a cart item to one of the cart's fulfillments | | [Cart Promotion](cart-promotion2-object-reference) | `s_c__Cart_Promotion2__c` | Records a promotion code applied to a cart | | [Cart Campaign](cart-campaign-object-reference) | `s_c__Cart_Campaign__c` | Links a cart to the marketing campaign it came from | | [Order](order-object-reference) | `Order` | The standard Salesforce order object, created from a cart at checkout | | [Order Item](orderitem-object-reference) | `OrderItem` | One line on an order: product, quantity, and the price charged | | [Order Item Tax](order-items-taxes-object-reference) | `s_c__Order_Items_Taxes__c` | The tax applied to one order line, one record per tax | | [Order Item Reward](order-item-reward-object-reference) | `s_c__Order_Item_Reward__c` | A reward granted against an order line | | [Order Campaign](order-campaign-object-reference) | `s_c__Order_Campaign__c` | Links an order to the marketing campaign it came from | | [Payment](payment-object-reference) | `s_c__Payment__c` | One attempt to take or refund money, with its gateway result | | [Payment Item](payment-item-object-reference) | `s_c__Payment_Item__c` | Allocates part of a payment to a specific order or fulfillment | | [Payment Method](payment-method-object-reference) | `s_c__Payment_Method__c` | A method offered at checkout, such as a card or account payment, and its surcharge | | [Payment Provider](payment-provider-object-reference) | `s_c__Payment_Provider__c` | A configured gateway, holding its credentials and which methods it supports | | [Payment Installment](payment-installment-object-reference) | `s_c__Payment_Installment__c` | One scheduled payment where the total is taken over time | | [Subscription](subscription-object-reference) | `s_c__Subscription__c` | A recurring purchase, its schedule, and its billing state | | [Subscription Change](subscription-change-object-reference) | `s_c__Subscription_Change__c` | A pending or applied change to a subscription, such as a new price or quantity | | [Voucher](voucher-object-reference) | `s_c__Voucher__c` | A gift card or credit note, with its balance, code, and PIN | | [Voucher Payment](voucher-payment-object-reference) | `s_c__Voucher_Payment__c` | Records a voucher being spent against a payment | | [Voucher Log](voucher-log-object-reference) | `s_c__Voucher_Log__c` | An entry for every change to a voucher's balance | | [Asset](asset-object-reference) | `Asset` | Serialized stock. Currently used as the template for the code and PIN issued on voucher creation | | [Promotion](promotion2-object-reference) | `s_c__Promotion2__c` | A promotion: what triggers it, what it gives, and when it runs | | [Promotion Condition](promotion2-condition-object-reference) | `s_c__Promotion2_Condition__c` | One test a cart must pass for a promotion to apply | | [Condition](condition-object-reference) | `s_c__Condition__c` | What must be true for a promotion reward to apply | | [Promotion Product Scope](promotion2-product-scope-object-reference) | `s_c__Promotion2_Product_Scope__c` | Limits a promotion to particular products or categories | | [Promotion Usage](promotion2-usage-object-reference) | `s_c__Promotion2Usage__c` | Records each use of a promotion, enforcing usage limits | | [Legacy Promotion](promotion-object-reference) | `s_c__Promotion__c` | The superseded promotions model, kept for existing data | | [Legacy Promotion Action](promotion-action-object-reference) | `s_c__Promotion_Action__c` | What a legacy promotion does when it applies | | [Legacy Promotion Scope](promotion-scope-object-reference) | `s_c__Promotion_Scope__c` | What a legacy promotion applies to | | [Promotion Credit](promotion-credit-object-reference) | `s_c__Promotion_Credit__c` | Account credit issued by a promotion | | [Discount](discount-object-reference) | `s_c__Discount__c` | An automatic price reduction, applied without a code | | [Discount Credit](discount-credit-object-reference) | `s_c__Discount_Credit__c` | Account credit issued by a discount | | [Reward](reward-object-reference) | `s_c__Reward__c` | A benefit earned by a shopper, such as points or a free item | | [Reward Usage](reward-usage-object-reference) | `s_c__Reward_Usage__c` | Records a reward being redeemed | | [Tax](tax-object-reference) | `s_c__Tax__c` | One tax rate and how it is applied | | [Tax Group](tax-group-object-reference) | `s_c__Tax_Group__c` | A set of taxes applied together, typically per region | | [Tax Tax Group](tax-tax-group-object-reference) | `s_c__Tax_Tax_Group__c` | Places a tax in a tax group | | [Product Tax](product-tax-object-reference) | `s_c__Product_Tax__c` | Applies a specific tax to a product | | [Product Tax Group](product-tax-group-object-reference) | `s_c__Product_Tax_Group__c` | Applies a tax group to a product | | [Tax Provider](tax-provider-object-reference) | `s_c__Tax_Provider__c` | An external tax calculation service and its credentials | | [Tax Provider Log](tax-provider-log-object-reference) | `s_c__Tax_Provider_Log__c` | The request and response for one external tax calculation | ## Where it meets other domains - **Catalog.** Cart items, order items, and promotion scopes all point at products and categories. Prices come from the price book, not the product. See [catalog objects](catalog-objects). - **Customers and accounts.** An order belongs to an account and a contact, and account credit is spent through payments. See [customer and account objects](customer-and-account-objects). - **Fulfillment and inventory.** Cart fulfillments become [shipments](shipment-object-reference) and [fulfillment items](fulfillment-item-object-reference) after checkout, and stock moves when they do. See [fulfillment and inventory objects](fulfillment-and-inventory-objects). - **Point of sale.** A POS sale creates the same cart, order, and payment records as the web, linked to the register and shift that took it. See [POS objects](pos-objects). Tax and promotion scoping both run through join records. If you are querying or importing one, [junction objects](junction-objects) explains what that means. --- ## Follow StoreConnect - [Email Newsletter](https://storeconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://storeconnect.com/partners) - [Become a Partner](https://storeconnect.com/become-a-partner) - [News](https://storeconnect.com/articles/news) - [Events](https://storeconnect.com/articles/events) - [Live Events](https://storeconnect.com/live-events) - [Feature Comparison](https://storeconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://storeconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS ## Machine-readable - [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format - [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map Every page and article on this site has a Markdown rendering: append `.md` to its URL. Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md) --- StoreConnect Support — https://support.storeconnect.com/articles/order-and-checkout-objects