> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "CartSubmitInput"
description: "The input fields required to submit a cart with the `submitCart` mutation. Provide the cart ID and billing address so Rye can place the order and initiate fulfillment. (Payment capture happens on your side before the cart is submitted.)"
---

## Fields

<ParamField path="id" type="ID!" required>
  The ID of the cart that the user wants to submit for processing. It's a unique identifier for the cart in the system, and it's used to identify the cart that needs to be submitted.
</ParamField>

<ParamField path="billingAddress" type={<a href="/api-reference/billingaddressinput">BillingAddressInput!</a>} required>
  The `BillingAddressInput` object containing the billing address information.
</ParamField>

<ParamField path="selectedShippingOptions" type={<a href="/api-reference/selectedshippingoption">[SelectedShippingOption!]</a>}>
  The selected shipping options for each store. If multiple shipping options are selected for a store, the last one selected will be used. If a store in the cart already has a shipping option selected (via the `updateCartSelectedShippingOptions` mutation), the selection specified here will override the previous one.
</ParamField>

<ParamField path="cartSettings" type={<a href="/api-reference/cartsettingsinput">CartSettingsInput</a>}>
  Field to set cart settings on cart creation.
</ParamField>

<ParamField path="experimentalPromoCodes" type={<a href="/api-reference/storepromocodesinput">[StorePromoCodesInput!]</a>}>
  Represents promo codes applied per store see [`StorePromoCodesInput`](/api-reference/storepromocodesinput) for more details.
</ParamField>

<Warning>This field is experimental and might be changed or removed in the future.</Warning>

<Note>
  * Currently promo codes work only for Shopify stores through our Sell Anything API
  * Shopify stores support only one promo code per store
</Note>

### Mutations

* [`submitCart`](/api-reference/submitcart)

***

### Related types

* [`SubmitCartResult`](/api-reference/submitcartresult)
* [`BuyerIdentityInput`](/api-reference/buyeridentityinput)
* [`SelectedShippingOption`](/api-reference/selectedshippingoption)


---

*Powered by [holocron.so](https://holocron.so)*