include

The discounted amount applied within a given context.

The coupon title based on different types provided in control panel section.

Cart Coupon

|Type `int`|Type Name|
|-|-|
|`0`|`per_item_discount`|
|`1`|`percentage_discount`|
|`2`|`per_total_discount`|
|`3`|`shipping_discount`|
|`4`|`free_shipping`|
|`5`|`promotion`|

Checkout Coupon

ISO 3166-1 alpha-2 country code. (See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

Indicates whether we should add this address to the customer address book.

Address Properties

Consignment Line Item

Create Consignment Request

Gift Certificate Request

One or more of these three fields is mandatory. You can update address and line items in one request. You have to update shipping option ID or pickup option ID in a separate request since changing the address or line items can invalidate the previously available shipping options.

Update Consignment Request

An option that represents a location where customers can pick up items.

Pickup Option

SpamProtectionRequest

address_Base

address_Full

Message shown to recipient, as provided by sender.

cartLineItemGiftCertificate_Put

cartLineItemPut

cart_Put

A cart contains a collection of items, prices, discounts, etc. It does not contain customer-related data.

Cost of cart’s contents, before applying discounts.

Sum of line-items amounts, minus cart-level discounts and coupons. This amount includes taxes, where applicable.

The currency in which prices are displayed; the store default currency.

ISO-4217 currency code. (See: http://en.wikipedia.org/wiki/ISO_4217.)

The number of decimal places for the currency. For example, the USD currency has two decimal places.

Currency

ID of the customer to which the cart belongs.

Applied Discount

The cartʼs email. This is the same email that is used in the billing address.

Cart ID, provided after creating a cart with a POST.

Boolean representing whether tax information is included.

Line Item

checkoutCart

Applied gift certificate (as a payment method).

The values presented here are projections of how much we would be using out of an existent gift certificate

Gift Certificate

checkoutGiftCertificates

checkoutTax

Shopperʼs message provided as details for the order to be created from this cart

Gift wrapping cost for all items, including or excluding tax.

The total payable amount, before applying any store credit or gift certificate.

Handling cost for all consignments including or excluding tax.

`true` value indicates StoreCredit has been applied.


`grandTotal` subtract the store-credit amount


Shipping cost before any discounts are applied.

Subtotal of the checkout before applying item-level discounts. Tax inclusive based on the store settings.

checkout_Full

checkout_Put

Address Response

Cart

This allows you to have multiple shipping addresses per checkout. Where there is only one shipping address, this array will contain only one value, with all the items.

Shopperʼs message provided as details for the order to be created from this cart.

Gift wrapping for all items, including or excluding tax.

Checkout

checkouts_Resp

consignmentAvailableShippingOptions

Specifies the type of shipping option; for example, flat rate, UPS, etc.

consignmentShippingOption_Base

This allows us to have multiple shipping addresses. Where there is only one shipping address, this array will contain only one value, with all the items.

This is available only when "include=consignments.availableShippingOptions" is present in the URL.

List of consignment discounts applied through coupons.

Consignment Coupon Discount

List of consignment discounts applied through cart level discounts.

Consignment Discount

The handling cost of shipping for this consignment.

Read only. Field used for Shipping Provider API.

Selected Shipping Option

consignment_Full

contactEntity

When doing a PUT or POST to the `fieldValue` with a pick list, the input must be a number. The response will be a string.

This can also be an array for fields that need to support list of values; for example, a set of checkboxes. When doing a PUT or POST to the `fieldValue` with a pick list, the input must be a number. The response will be a string.

customFields

BigCommerce

Manage checkout operations and data using front-end JavaScript on BigCommerce
Stencil-powered storefronts.

For info about API accounts, see our [Guide to API Accounts](/docs/start/authentication/api-accounts).
    
For info about authenticating BigCommerce APIs, see [Authentication and Example Requests](/docs/start/authentication#same-origin-cors-authentication).

Storefront Checkouts

Returns a *Checkout*.

The cart ID and checkout ID are the same.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

checkoutId

* `cart.lineItems.physicalItems.options` - physical options
* `cart.lineItems.digitalItems.options` - digital options
* `cart.lineItems.physicalItems.categoryNames` - physical categories
* `cart.lineItems.digitalItems.categoryNames` - digital categories
* `cart.lineItems.customItems.categoryNames` - custom categories
* `customer` - customer
* `customer.customerGroup` - customer group
* `payments` - payments
* `promotions` - promotions
* `consignments.availableShippingOptions` - shipping options

When a problem arises, returns a generic response.

Updates *Checkout* customer messages.

**Limits**

* 2000 character limit

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Adds a billing address to an existing *Checkout*.

**Required Fields**
* country_code


> #### Note
> * The `email` property is only required if the customer is a guest shopper. Otherwise, it is set automatically.
> * Sending `email` property as a payload in POST request triggers the abandoned cart notification process.
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

The email trying to be set for the guest is associated with an account. The customer must sign in.

Unable to determine if provided email is associated with an account. The customer must sign in.

Updates an existing billing address on *Checkout*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

addressId

Deletes a *Line Item* from the *Cart*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

cartId

itemId

NOTE: Discounted line items are re-evaluated on cart actions and may be automatically added back to your cart with a new line item ID to satisfy promotional requirements.

Updates a *Checkout Line Item*. Updates an existing, single line item in the cart.

If a variant needs to be changed or updated, the product will need to be removed and re-added to the cart with the correct variants using the [Add Cart Line Items](/docs/rest-storefront/carts/cart-items#add-cart-line-items) endpoint or the [GraphQL Storefront API](/docs/storefront/cart-checkout/guide/graphql-storefront).

> #### Notes
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint. 
> * Please note that this API endpoint is not concurrent safe, meaning multiple simultaneous requests could result in unexpected and inconsistent results.

Adds a new *Consignment* to *Checkout*.

Perform the following two steps to define the fulfillment of the items in the cart.
  ### For **shipping** consignments:
    1. Add a new Consignment to Checkout.
        * Send a `POST` request to `/consignments` with each shipping address, line item IDs, and quantities. Each address can have its own line item IDs.
        * Provide a full valid customer address before placing the order. If provided, the order placement will succeed. 
        * As part of the request URL make sure to add `include=consignments.availableShippingOptions` to return the available shipping options based on the items, the address, and the shipping location. This will return `availableShippingOptions` in the response.

      * Required Fields:
        * `shipping_address` (deprecated) or `address`
        * `lineItems`
    2. Update the Consignment with Shipping Options using the [REST Storefront API](/checkouts/checkout-consignments#update-a-consignment), the [REST Management API](/docs/rest-management/checkouts/checkout-consignments#update-checkout-consignment) or the [GraphQL Storefront API](/docs/storefront/cart-checkout/guide/graphql-storefront).
          
  ### For **pickup** consignments:
    1. Create a new consignment object. 
      - Send a `POST` request to `/consignments` with line item IDs and quantities.
      - Provide a `pickupMethodId`. This is the `id` of the Pickup Method provided in the response body of the Storefront Pickup Options API.
      - Required Fields:
          * `pickupOption`
          * `lineItems`

To learn more about creating a Checkout Consignment, see the [Carts and Checkouts Tutorial](/docs/storefront/cart-checkout/guide/rest-storefront).

> #### Notes
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.
> * Please note that this API endpoint is not concurrent safe, meaning multiple simultaneous requests could result in unexpected and inconsistent results.


Removes an existing *Consignment* from *Checkout*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

consignmentId

Updates an existing consignment. An update is either one of the following:

1. Updates the consignment address and/or line items.
2. Selects a specific fulfillment option.

### Update the consignment address and line items
For this type of update, the payload is the same as when creating a new consignment.         Update each *Consignment* `shippingOptionId` (shipping address and line items) with the `availableShippingOption > id` from the POST `/consignment` response. 

**Note:**
Updating a consignment could invalidate the value for `selectedShippingOption` and `selectedPickupOption`.

### Select a specific fulfillment option
Before placing an order, each consignment must have a `selectedShippingOption` or a `selectedPickupOption`.

If the consignment already has a pick-up option selected and a shipping option is provided, the pick-up option will be deselected and the shipping option will be selected instead (and vice versa). The `PUT` request will fail if it contains a shipping option ID and a pickup option ID.

Required Fields:
* `shippingOptionId` or `pickupOptionId`
* `lineItems`

To learn more about creating a Checkout Consignment see [Checkout Consignment API](/docs/storefront/cart-checkout/guide/consignments).

> #### Notes
> * You cannot pass both an `address` and a `shippingOptionId` because the shipping option may not be available for the new address 
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.
> * Please note that this API endpoint is not concurrent safe, meaning multiple simultaneous requests could result in unexpected and inconsistent results.

Adds a *Coupon Code* to *Checkout*.

**Required Fields**
* couponCode

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Coupon Code Request

Deletes a *Coupon Code* from *Checkout*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  


couponCode

Adds a *Gift Certificate Code* to *Checkout*.

> #### Note
> * *Gift Certificates* are treated as a payment methods.
> * You are not able to purchase a gift certificate with a gift certificate.
> * The rate limit is 20/hour (only for unique gift-certificate codes).
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Deletes an existing *Gift Certificate*.

This removes the *Gift Certificate* payment method.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

giftCertificateCode

Verifies if checkout is created by human.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Removes store credit from a checkout.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Applies any available store credit to a checkout. As on the storefront, all available store credit will be used (up to the value of the order) and no amount need be specified.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.

The [URL authority](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL#authority) of the storefront.

Storefront Checkouts

Get a Checkout

Request

Note

Parameters

example

Response

Body

dataobject

example

Update Customer Messages

Request

Note

Parameters

Body

customerMessagestring

example

Response

Body

dataobject

example