---
title: "Create Order Token"
method: POST
path: "/v1/merchant/orders"
tags: ["Orders"]
---

# Create Order Token

`POST /v1/merchant/orders`

Make a request to this endpoint to create a Bolt order, generate a Bolt order token, and initiate the checkout process. A Bolt order token is required for Bolt orders; see Non-Bolt orders for alternative use cases.

## Request body

- OrderCreate
  - `cart` object, required — The cart_create object is a composite of the base_cart object and additional order details.
    - `add_ons` CartAddOn[]
      - `description` string — The description of the product being displayed as an add on.
      - `imageUrl` string — The URL of the image displayed for the add on product.
      - `name` string, required — The name of the product being displayed as an add on.
      - `price` number, required — The price of the product add on in cents (1/100).
      - `productId` string, required — The the ID of the product being displayed as an add on.
      - `productPageUrl` string — The URL to the product page of the product being displayed as an add on.
    - `billing_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
      - `company` string — The company name associated with this address.
      - `country` string — The name of the country associated with this address.
      - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
      - `default` boolean — Whether the added address is now the default address.
      - `door_code` string, nullable — The building door code or community gate code.
      - `email` string, email, required — An email address.
      - `first_name` string, required — The given name of the person associated with this address.
      - `last_name` string, required — The surname of the person associated with this address.
      - `locality` string, required — The city name details associated with this address.
      - `name` string — The given and surname of the person associated with this address.
      - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
      - `postal_code` string, required — The the postal or zip code associated with this address.
      - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
      - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
      - `street_address1` string, required — The street number and street name of the address.
      - `street_address2` string — Any apartment, floor, or unit details.
      - `street_address3` string, nullable — Any additional street address details.
      - `street_address4` string, nullable — Any additional street address details.
    - `discounts` CartDiscount[]
      - `amount` number
      - `code` string
      - `description` string — Used to define the discount offering.
      - `details_url` string — Used to provide a link to additional details, such as a landing page, associated with the discount offering.
      - `discount_category` 'coupon' | 'giftcard' | 'managed_giftcard' | 'store_credit' | 'automatic_promotion' | 'membership_discount' | 'membership_giftcard' | 'subscription_discount' | 'rewards_discount' | 'shipping_discount' | 'unknown'
      - `reference` string — Used to define the reference ID associated with the discount available.
      - `type` 'fixed_amount' | 'percentage' | 'free_shipping' — The type of discount.
    - `fees` CartFee[]
      - `reference` string, required — Unique reference used to identify the fee.
      - `name` string, nullable, required — Name of the fee that will appear in the order ledger.
      - `description` string, nullable — Description of the fee that will appear in the tooltip if the mouse hovers over the fee.
      - `unit_price` number, required
      - `unit_tax_amount` number, required
      - `quantity` number, required
    - `fulfillments` Fulfillment[]
      - `cart_items` CartItem[]
        - `brand` string, nullable
        - `category` string, nullable — Used to define a product category associated with the item.
        - `collections` Collection[]
        - `color` string, nullable — Used to define the color of the item.
        - `customizations` CartItemCustomization[]
          - `attributes` object
          - `name` string
          - `price` number
        - `description` string, nullable
        - `details_url` string — Used to provide a link to the item's product page.
        - `external_inputs` ICartItemExternalInputs
          - `shopify_line_item_reference` number
          - `shopify_product_reference` number
          - `shopify_product_variant_reference` number
        - `gift_option` CartItemGiftOption — Contains the gift option settings for wrapping and custom messages.
          - `cost` integer — The cost in cents.
          - `merchant_product_id` string — The merchant's unique ID for the product.
          - `message` string — Includes the gift message written by the shopper.
          - `wrap` boolean — Defines whether gift wrapping was requested.
        - `image_url` string — Used to provide a link to the image associated with the item.
        - `isbn` string, nullable — Used to define the International Standard Book Number associated with the book.
        - `item_group` string, nullable
        - `manufacturer` string, nullable — Used to define the organization that manufactured the item.
        - `merchant_product_id` string — The merchant's unique ID for the product.
        - `merchant_variant_id` string — A merchant's unique ID for a given product's specific variant.
        - `msrp` number, nullable
        - `name` string, required
        - `options` string, nullable
        - `properties` CartItemProperty[]
          - `color` string
          - `display` boolean
          - `name` string
          - `name_id` number
          - `value` string
          - `value_id` number
        - `quantity` number, required
        - `reference` string, required
        - `shipment` CartShipment — A cart that is being prepared for shipment
          - `carrier` string — The name of the carrier selected.
          - `cost` integer — The cost in cents.
          - `discounted_by_membership` boolean — Defines if shopper has a membership discount.
          - `estimated_delivery_date` string — The estimated delivery date.
          - `expedited` boolean — True if shipment is expedited.
          - `package_depth` integer — The depth.
          - `package_dimension_unit` string — The unit of measurement for an item's dimensions.
          - `package_height` integer — The height.
          - `package_type` string — The type of package.
          - `package_weight_unit` string — The unit of measurement for an item's weight.
          - `package_width` integer — The width.
          - `service` string — The service name.
          - `shipping_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
            - `company` string — The company name associated with this address.
            - `country` string — The name of the country associated with this address.
            - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
            - `default` boolean — Whether the added address is now the default address.
            - `door_code` string, nullable — The building door code or community gate code.
            - `email` string, email, required — An email address.
            - `first_name` string, required — The given name of the person associated with this address.
            - `last_name` string, required — The surname of the person associated with this address.
            - `locality` string, required — The city name details associated with this address.
            - `name` string — The given and surname of the person associated with this address.
            - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
            - `postal_code` string, required — The the postal or zip code associated with this address.
            - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
            - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
            - `street_address1` string, required — The street number and street name of the address.
            - `street_address2` string — Any apartment, floor, or unit details.
            - `street_address3` string, nullable — Any additional street address details.
            - `street_address4` string, nullable — Any additional street address details.
          - `shipping_address_id` string — ID for billing address
          - `shipping_method` string — The name of the shipping method.
          - `signature` string — The signature.
          - `tax_amount` integer — Tax amount in cents.
          - `tax_code` string — The relevant tax code.
          - `total_weight` integer — The total weight.
          - `total_weight_unit` string — The unit of measurement for an item's weight.
          - `type` 'door_delivery' | 'in_store_pickup' | 'ship_to_store' | 'ship_to_home_only' | 'unknown' — The type corresponding to this shipment, if applicable.
        - `shipment_type` 'unknown' | 'door_delivery' | 'ship_to_store' | 'in_store_pickup'
        - `size` string, nullable — Used to define the size of the item.
        - `sku` string, nullable — Used to define the alpha-numberic Stock Keeping Unit associated with the item as it is mapped to your internal product catalogue.
        - `source` string, nullable
        - `seller_id` string, nullable — The unique identifier for the seller within the marketplace ecosystem. This field ensures deterministic multi-party payout calculations.
        - `tags` string, nullable — Used to define a comma-separated list of tags associated with the item.
        - `tax_amount` number, nullable — The tax amount for the item; this value should scale with the quantity of units selected.
        - `tax_code` string, nullable
        - `taxable` boolean, nullable
        - `total_amount` number, required — The total amount, in cents, of the item including its taxes if applicable.
        - `type` 'unknown' | 'digital' | 'physical' | 'bundled'
        - `unit_price` number, required — The price of one unit of the item; for example, the price of one pack of socks.
        - `uom` string, nullable — Used to define the unit of measure used to describe the item.
        - `upc` string, nullable — Used to define the 12-digit Universal Product Code (a barcode) associated with the item worldwide.
        - `weight` number, nullable
        - `weight_unit` string, nullable
      - `cart_shipment` CartShipment — A cart that is being prepared for shipment
        - `carrier` string — The name of the carrier selected.
        - `cost` integer — The cost in cents.
        - `discounted_by_membership` boolean — Defines if shopper has a membership discount.
        - `estimated_delivery_date` string — The estimated delivery date.
        - `expedited` boolean — True if shipment is expedited.
        - `package_depth` integer — The depth.
        - `package_dimension_unit` string — The unit of measurement for an item's dimensions.
        - `package_height` integer — The height.
        - `package_type` string — The type of package.
        - `package_weight_unit` string — The unit of measurement for an item's weight.
        - `package_width` integer — The width.
        - `service` string — The service name.
        - `shipping_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
          - `company` string — The company name associated with this address.
          - `country` string — The name of the country associated with this address.
          - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
          - `default` boolean — Whether the added address is now the default address.
          - `door_code` string, nullable — The building door code or community gate code.
          - `email` string, email, required — An email address.
          - `first_name` string, required — The given name of the person associated with this address.
          - `last_name` string, required — The surname of the person associated with this address.
          - `locality` string, required — The city name details associated with this address.
          - `name` string — The given and surname of the person associated with this address.
          - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
          - `postal_code` string, required — The the postal or zip code associated with this address.
          - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
          - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
          - `street_address1` string, required — The street number and street name of the address.
          - `street_address2` string — Any apartment, floor, or unit details.
          - `street_address3` string, nullable — Any additional street address details.
          - `street_address4` string, nullable — Any additional street address details.
        - `shipping_address_id` string — ID for billing address
        - `shipping_method` string — The name of the shipping method.
        - `signature` string — The signature.
        - `tax_amount` integer — Tax amount in cents.
        - `tax_code` string — The relevant tax code.
        - `total_weight` integer — The total weight.
        - `total_weight_unit` string — The unit of measurement for an item's weight.
        - `type` 'door_delivery' | 'in_store_pickup' | 'ship_to_store' | 'ship_to_home_only' | 'unknown' — The type corresponding to this shipment, if applicable.
      - `digital_delivery` DigitalDelivery
        - `email` string
        - `phone` string
      - `in_store_cart_shipment` InStoreCartShipment
        - `cart_shipment` CartShipment — A cart that is being prepared for shipment
          - `carrier` string — The name of the carrier selected.
          - `cost` integer — The cost in cents.
          - `discounted_by_membership` boolean — Defines if shopper has a membership discount.
          - `estimated_delivery_date` string — The estimated delivery date.
          - `expedited` boolean — True if shipment is expedited.
          - `package_depth` integer — The depth.
          - `package_dimension_unit` string — The unit of measurement for an item's dimensions.
          - `package_height` integer — The height.
          - `package_type` string — The type of package.
          - `package_weight_unit` string — The unit of measurement for an item's weight.
          - `package_width` integer — The width.
          - `service` string — The service name.
          - `shipping_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
            - `company` string — The company name associated with this address.
            - `country` string — The name of the country associated with this address.
            - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
            - `default` boolean — Whether the added address is now the default address.
            - `door_code` string, nullable — The building door code or community gate code.
            - `email` string, email, required — An email address.
            - `first_name` string, required — The given name of the person associated with this address.
            - `last_name` string, required — The surname of the person associated with this address.
            - `locality` string, required — The city name details associated with this address.
            - `name` string — The given and surname of the person associated with this address.
            - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
            - `postal_code` string, required — The the postal or zip code associated with this address.
            - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
            - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
            - `street_address1` string, required — The street number and street name of the address.
            - `street_address2` string — Any apartment, floor, or unit details.
            - `street_address3` string, nullable — Any additional street address details.
            - `street_address4` string, nullable — Any additional street address details.
          - `shipping_address_id` string — ID for billing address
          - `shipping_method` string — The name of the shipping method.
          - `signature` string — The signature.
          - `tax_amount` integer — Tax amount in cents.
          - `tax_code` string — The relevant tax code.
          - `total_weight` integer — The total weight.
          - `total_weight_unit` string — The unit of measurement for an item's weight.
          - `type` 'door_delivery' | 'in_store_pickup' | 'ship_to_store' | 'ship_to_home_only' | 'unknown' — The type corresponding to this shipment, if applicable.
        - `description` string — Shipment option description.
        - `distance` number
        - `distance_unit` 'km' | 'mile'
        - `in_store_pickup_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
          - `company` string — The company name associated with this address.
          - `country` string — The name of the country associated with this address.
          - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
          - `default` boolean — Whether the added address is now the default address.
          - `door_code` string, nullable — The building door code or community gate code.
          - `email` string, email, required — An email address.
          - `first_name` string, required — The given name of the person associated with this address.
          - `last_name` string, required — The surname of the person associated with this address.
          - `locality` string, required — The city name details associated with this address.
          - `name` string — The given and surname of the person associated with this address.
          - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
          - `postal_code` string, required — The the postal or zip code associated with this address.
          - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
          - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
          - `street_address1` string, required — The street number and street name of the address.
          - `street_address2` string — Any apartment, floor, or unit details.
          - `street_address3` string, nullable — Any additional street address details.
          - `street_address4` string, nullable — Any additional street address details.
        - `pickup_window_close` integer
        - `pickup_window_open` integer
        - `store_name` string — The local store's name where the item can be picked up.
      - `type` 'physical_door_delivery' | 'physical_ship_to_store' | 'physical_in_store_pickup' | 'digital_download' | 'digital_no_delivery'
    - `in_store_cart_shipments` InStoreCartShipment[]
      - `cart_shipment` CartShipment — A cart that is being prepared for shipment
        - `carrier` string — The name of the carrier selected.
        - `cost` integer — The cost in cents.
        - `discounted_by_membership` boolean — Defines if shopper has a membership discount.
        - `estimated_delivery_date` string — The estimated delivery date.
        - `expedited` boolean — True if shipment is expedited.
        - `package_depth` integer — The depth.
        - `package_dimension_unit` string — The unit of measurement for an item's dimensions.
        - `package_height` integer — The height.
        - `package_type` string — The type of package.
        - `package_weight_unit` string — The unit of measurement for an item's weight.
        - `package_width` integer — The width.
        - `service` string — The service name.
        - `shipping_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
          - `company` string — The company name associated with this address.
          - `country` string — The name of the country associated with this address.
          - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
          - `default` boolean — Whether the added address is now the default address.
          - `door_code` string, nullable — The building door code or community gate code.
          - `email` string, email, required — An email address.
          - `first_name` string, required — The given name of the person associated with this address.
          - `last_name` string, required — The surname of the person associated with this address.
          - `locality` string, required — The city name details associated with this address.
          - `name` string — The given and surname of the person associated with this address.
          - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
          - `postal_code` string, required — The the postal or zip code associated with this address.
          - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
          - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
          - `street_address1` string, required — The street number and street name of the address.
          - `street_address2` string — Any apartment, floor, or unit details.
          - `street_address3` string, nullable — Any additional street address details.
          - `street_address4` string, nullable — Any additional street address details.
        - `shipping_address_id` string — ID for billing address
        - `shipping_method` string — The name of the shipping method.
        - `signature` string — The signature.
        - `tax_amount` integer — Tax amount in cents.
        - `tax_code` string — The relevant tax code.
        - `total_weight` integer — The total weight.
        - `total_weight_unit` string — The unit of measurement for an item's weight.
        - `type` 'door_delivery' | 'in_store_pickup' | 'ship_to_store' | 'ship_to_home_only' | 'unknown' — The type corresponding to this shipment, if applicable.
      - `description` string — Shipment option description.
      - `distance` number
      - `distance_unit` 'km' | 'mile'
      - `in_store_pickup_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
        - `company` string — The company name associated with this address.
        - `country` string — The name of the country associated with this address.
        - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
        - `default` boolean — Whether the added address is now the default address.
        - `door_code` string, nullable — The building door code or community gate code.
        - `email` string, email, required — An email address.
        - `first_name` string, required — The given name of the person associated with this address.
        - `last_name` string, required — The surname of the person associated with this address.
        - `locality` string, required — The city name details associated with this address.
        - `name` string — The given and surname of the person associated with this address.
        - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
        - `postal_code` string, required — The the postal or zip code associated with this address.
        - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
        - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
        - `street_address1` string, required — The street number and street name of the address.
        - `street_address2` string — Any apartment, floor, or unit details.
        - `street_address3` string, nullable — Any additional street address details.
        - `street_address4` string, nullable — Any additional street address details.
      - `pickup_window_close` integer
      - `pickup_window_open` integer
      - `store_name` string — The local store's name where the item can be picked up.
    - `items` CartItem[] — The list of items associated with the cart.
      - `brand` string, nullable
      - `category` string, nullable — Used to define a product category associated with the item.
      - `collections` Collection[]
      - `color` string, nullable — Used to define the color of the item.
      - `customizations` CartItemCustomization[]
        - `attributes` object
        - `name` string
        - `price` number
      - `description` string, nullable
      - `details_url` string — Used to provide a link to the item's product page.
      - `external_inputs` ICartItemExternalInputs
        - `shopify_line_item_reference` number
        - `shopify_product_reference` number
        - `shopify_product_variant_reference` number
      - `gift_option` CartItemGiftOption — Contains the gift option settings for wrapping and custom messages.
        - `cost` integer — The cost in cents.
        - `merchant_product_id` string — The merchant's unique ID for the product.
        - `message` string — Includes the gift message written by the shopper.
        - `wrap` boolean — Defines whether gift wrapping was requested.
      - `image_url` string — Used to provide a link to the image associated with the item.
      - `isbn` string, nullable — Used to define the International Standard Book Number associated with the book.
      - `item_group` string, nullable
      - `manufacturer` string, nullable — Used to define the organization that manufactured the item.
      - `merchant_product_id` string — The merchant's unique ID for the product.
      - `merchant_variant_id` string — A merchant's unique ID for a given product's specific variant.
      - `msrp` number, nullable
      - `name` string, required
      - `options` string, nullable
      - `properties` CartItemProperty[]
        - `color` string
        - `display` boolean
        - `name` string
        - `name_id` number
        - `value` string
        - `value_id` number
      - `quantity` number, required
      - `reference` string, required
      - `shipment` CartShipment — A cart that is being prepared for shipment
        - `carrier` string — The name of the carrier selected.
        - `cost` integer — The cost in cents.
        - `discounted_by_membership` boolean — Defines if shopper has a membership discount.
        - `estimated_delivery_date` string — The estimated delivery date.
        - `expedited` boolean — True if shipment is expedited.
        - `package_depth` integer — The depth.
        - `package_dimension_unit` string — The unit of measurement for an item's dimensions.
        - `package_height` integer — The height.
        - `package_type` string — The type of package.
        - `package_weight_unit` string — The unit of measurement for an item's weight.
        - `package_width` integer — The width.
        - `service` string — The service name.
        - `shipping_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
          - `company` string — The company name associated with this address.
          - `country` string — The name of the country associated with this address.
          - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
          - `default` boolean — Whether the added address is now the default address.
          - `door_code` string, nullable — The building door code or community gate code.
          - `email` string, email, required — An email address.
          - `first_name` string, required — The given name of the person associated with this address.
          - `last_name` string, required — The surname of the person associated with this address.
          - `locality` string, required — The city name details associated with this address.
          - `name` string — The given and surname of the person associated with this address.
          - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
          - `postal_code` string, required — The the postal or zip code associated with this address.
          - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
          - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
          - `street_address1` string, required — The street number and street name of the address.
          - `street_address2` string — Any apartment, floor, or unit details.
          - `street_address3` string, nullable — Any additional street address details.
          - `street_address4` string, nullable — Any additional street address details.
        - `shipping_address_id` string — ID for billing address
        - `shipping_method` string — The name of the shipping method.
        - `signature` string — The signature.
        - `tax_amount` integer — Tax amount in cents.
        - `tax_code` string — The relevant tax code.
        - `total_weight` integer — The total weight.
        - `total_weight_unit` string — The unit of measurement for an item's weight.
        - `type` 'door_delivery' | 'in_store_pickup' | 'ship_to_store' | 'ship_to_home_only' | 'unknown' — The type corresponding to this shipment, if applicable.
      - `shipment_type` 'unknown' | 'door_delivery' | 'ship_to_store' | 'in_store_pickup'
      - `size` string, nullable — Used to define the size of the item.
      - `sku` string, nullable — Used to define the alpha-numberic Stock Keeping Unit associated with the item as it is mapped to your internal product catalogue.
      - `source` string, nullable
      - `seller_id` string, nullable — The unique identifier for the seller within the marketplace ecosystem. This field ensures deterministic multi-party payout calculations.
      - `tags` string, nullable — Used to define a comma-separated list of tags associated with the item.
      - `tax_amount` number, nullable — The tax amount for the item; this value should scale with the quantity of units selected.
      - `tax_code` string, nullable
      - `taxable` boolean, nullable
      - `total_amount` number, required — The total amount, in cents, of the item including its taxes if applicable.
      - `type` 'unknown' | 'digital' | 'physical' | 'bundled'
      - `unit_price` number, required — The price of one unit of the item; for example, the price of one pack of socks.
      - `uom` string, nullable — Used to define the unit of measure used to describe the item.
      - `upc` string, nullable — Used to define the 12-digit Universal Product Code (a barcode) associated with the item worldwide.
      - `weight` number, nullable
      - `weight_unit` string, nullable
    - `loyalty_rewards` CartLoyaltyRewards[]
      - `amount` number — The reward amount in cents (1/100).
      - `coupon_code` string — The loyalty reward's coupon code.
      - `description` string — A description of the loyalty reward that will be shown to the shopper.
      - `details` string — Internal-facing metadata for the Loyalty Rewards. Ideal for adding any other identifying information about the reward, including a duplication of the original loyalty reward json response from the loyalty provider as shown in the example provided. If you choose to use this field to hold json, enclose the content in single quotes to force a string value.
      - `points` number — The number of points needed for this reward.
      - `source` string — The loyalty rewards provider.
      - `type` string — The type of loyalty reward.
    - `shipments` CartShipment[]
      - `carrier` string — The name of the carrier selected.
      - `cost` integer — The cost in cents.
      - `discounted_by_membership` boolean — Defines if shopper has a membership discount.
      - `estimated_delivery_date` string — The estimated delivery date.
      - `expedited` boolean — True if shipment is expedited.
      - `package_depth` integer — The depth.
      - `package_dimension_unit` string — The unit of measurement for an item's dimensions.
      - `package_height` integer — The height.
      - `package_type` string — The type of package.
      - `package_weight_unit` string — The unit of measurement for an item's weight.
      - `package_width` integer — The width.
      - `service` string — The service name.
      - `shipping_address` Address — The Address object is used for billing, shipping, and physical store address use cases.
        - `company` string — The company name associated with this address.
        - `country` string — The name of the country associated with this address.
        - `country_code` string, required — The ISO 3166-1 alpha-2 country code associated with this address.
        - `default` boolean — Whether the added address is now the default address.
        - `door_code` string, nullable — The building door code or community gate code.
        - `email` string, email, required — An email address.
        - `first_name` string, required — The given name of the person associated with this address.
        - `last_name` string, required — The surname of the person associated with this address.
        - `locality` string, required — The city name details associated with this address.
        - `name` string — The given and surname of the person associated with this address.
        - `phone` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
        - `postal_code` string, required — The the postal or zip code associated with this address.
        - `region` string, required — **Not Required for NON US addresses**. The region details such as state or province associated with this address.
        - `region_code` string, nullable — The ISO 3166-2 region code associated with this address. - * If specified, value must be valid for the `country`. - * If null, value is inferred from the `region`.
        - `street_address1` string, required — The street number and street name of the address.
        - `street_address2` string — Any apartment, floor, or unit details.
        - `street_address3` string, nullable — Any additional street address details.
        - `street_address4` string, nullable — Any additional street address details.
      - `shipping_address_id` string — ID for billing address
      - `shipping_method` string — The name of the shipping method.
      - `signature` string — The signature.
      - `tax_amount` integer — Tax amount in cents.
      - `tax_code` string — The relevant tax code.
      - `total_weight` integer — The total weight.
      - `total_weight_unit` string — The unit of measurement for an item's weight.
      - `type` 'door_delivery' | 'in_store_pickup' | 'ship_to_store' | 'ship_to_home_only' | 'unknown' — The type corresponding to this shipment, if applicable.
    - `tax_amount` number — The total tax amount for all of the items associated with the cart.
    - `total_amount` number, required — The total amount, in cents, of the cart including its items and taxes (if applicable), e.g. $9.00 is 900. This total must match the sum of all other amounts.
    - `cart_url` string — Used to provide a link to the cart ID.
    - `currency` string, required
    - `display_id` string — This field, although required, can be an empty string.
    - `metadata` object — Optional custom metadata.
    - `order_description` string — Used optionally to pass additional information like order numbers or other IDs as needed.
    - `order_reference` string, required — This value is used by Bolt as an external reference to a given order. This reference must be unique per successful transaction.
  - `channel` 'browser' | 'mobile_app', required — Used to determine the channel from which the order was created.
  - `create_cart_on_merchant_backend` boolean, nullable — Used to determine whether the order is created on your backend platform. This should almost always be `false`.
  - `metadata` IOrderMetadata, nullable
    - `encrypted_user_id` string
  - `user_note` string — Optionally used by shoppers to make extra requests or provide details for gift messages.
  - `seller_splits` SellerSplit[], nullable — Array of seller splits for marketplace orders. This enables marketplaces to dynamically configure commission fees and payment splits per seller. Each split contains seller identification, scoped line items and shipments, and declarative amount breakdowns.
    - `seller_id` string, required — The unique identifier for the seller within the marketplace ecosystem.
    - `amounts` SellerSplitAmounts, required — Defines the financial breakdown for a seller split, including subtotals, discounts, shipping, taxes, and the final gross amount.
      - `merchant_subtotal` number, required — The subtotal amount for the merchant's items in this split, in cents.
      - `discount_total` number, required — The total discount amount applied to this seller split, in cents.
      - `shipping_total` number, required — The total shipping amount for this seller split, in cents.
      - `tax_total` number, required — The total tax amount for this seller split, in cents.
      - `gross_total` number, required — The gross total amount for this seller split, in cents.
    - `marketplace_commission_fee` MarketplaceCommissionFee, required — Configures the marketplace commission fee structure for a seller split, supporting both percentage-based and flat fee models.
      - `bps` number, required — The commission fee expressed in basis points (1 bps = 0.01%). For example, 100 bps = 1%, 250 bps = 2.5%.
      - `flat_cents` number, required — The fixed commission fee amount in cents, applied regardless of transaction value.
      - `metadata` object, nullable — Additional contextual information about the commission fee, such as plan type, tier level, or other business rules.

## Response `200`

Token Generation Successful

- IOrderView
  - `cart` ICartView — This is the cart object returned in a successful response.
    - `billing_address` AddressView — The address object returned in the response.
      - `company` string — The company name associated with this address.
      - `country` string — The name of the country associated with this address.
      - `country_code` string — The ISO 3166-1 alpha-2 country code associated with this address.
      - `door_code` string, nullable — The building door code or community gate code.
      - `email_address` string, email — An email address.
      - `first_name` string — The given name of the person associated with this address.
      - `id` string — The unique Bolt ID associated with this address.
      - `last_name` string — The surname of the person associated with this address.
      - `locality` string — The city name details associated with this address.
      - `name` string — The given and surname of the person associated with this address.
      - `phone_number` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
      - `postal_code` string — The postal or zip code associated with this address.
      - `priority` 'primary' | 'listed', nullable — The shopper-indicated priority of this address compared to other addresses on their account.
      - `region` string — The region details such as state or province associated with this address.
      - `region_code` string, nullable — The the ISO 3166-2 region code associated with this address.
      - `street_address1` string — The street number and street name of the address.
      - `street_address2` string — Any apartment, floor, or unit details.
      - `street_address3` string, nullable — Any additional street address details.
      - `street_address4` string, nullable — Any additional street address details.
    - `cart_url` string — Used to provide a link to the cart ID.
    - `currency` ICurrency
      - `currency` string
      - `currency_symbol` string
    - `discount_amount` AmountView
      - `amount` number
      - `currency` string
      - `currency_symbol` string
    - `discounts` ICartDiscountView[]
      - `amount` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `code` string — Discount code used.
      - `description` string — Used to define the discount offering.
      - `details_url` string — Used to provide a link to additional details, such as a landing page, associated with the discount offering.
      - `discount_category` 'coupon' | 'giftcard' | 'managed_giftcard' | 'store_credit' | 'automatic_promotion' | 'membership_discount' | 'membership_giftcard' | 'subscription_discount' | 'rewards_discount' | 'shipping_discount' | 'unknown'
      - `free_shipping` IFreeShippingDiscountView
        - `is_free_shipping` boolean
        - `maximum_cost_allowed` number
      - `reference` string — Used to define the reference ID associated with the discount available.
    - `display_id` string
    - `fee_amount` AmountView
      - `amount` number
      - `currency` string
      - `currency_symbol` string
    - `fees` ICartFeeView[]
      - `reference` string — Unique reference used to identify the fee.
      - `name` string, nullable — Name of the fee that will appear in the order ledger.
      - `description` string, nullable — Description of the fee that will appear in the tooltip if the mouse hovers over the fee.
      - `unit_price` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `unit_tax_amount` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `quantity` number
    - `items` ICartItemView[]
      - `bolt_product_id` string
      - `brand` string
      - `category` string, nullable — Used to define a product category associated with the item.
      - `collections` Collection[]
      - `color` string — Used to define the color of the item.
      - `customizations` CartItemCustomization[]
        - `attributes` object
        - `name` string
        - `price` number
      - `description` string
      - `details_url` string — Used to provide a link to the item's product page.
      - `gift_option` GiftOptionView — Defines which gift options are hidden.
        - `hide_gift_message` boolean
        - `hide_gift_wrap` boolean
      - `hide` boolean
      - `image_url` string — Used to provide a link to the image associated with the item.
      - `isbn` string, nullable — Used to define the International Standard Book Number associated with the book.
      - `item_group` string
      - `manufacturer` string, nullable — Used to define the organization that manufactured the item.
      - `merchant_product_id` string
      - `merchant_variant_id` string
      - `msrp` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `name` string
      - `options` string
      - `properties` CartItemPropertyView[]
        - `color` string
        - `display` boolean
        - `name` string
        - `value` string
      - `quantity` number
      - `reference` string
      - `shipment_id` string
      - `shipment_type` 'unknown' | 'door_delivery' | 'ship_to_store' | 'in_store_pickup' | 'ship_to_home_only'
      - `shopify_line_item_reference` number
      - `shopify_product_reference` number
      - `shopify_product_variant_reference` number
      - `size` string — Used to define the size of the item.
      - `sku` string, nullable — Used to define an alpha-numeric Stock Keeping Unit associated with the item as it is mapped to your internal product catalogue.
      - `subscription` Subscription — Describes a product added as a recurring subscription.
        - `frequency` object — Describes how often the subscription recurs.
          - `unit` 'day' | 'week' | 'month' | 'year' — The unit for this subscription's frequency.
          - `value` integer — The value applied to the unit frequency.
      - `tags` string — Used to define a comma-separated list of tags associated with the item.
      - `tax_amount` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `taxable` boolean
      - `total_amount` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `type` 'unknown' | 'digital' | 'physical' | 'bundled'
      - `unit_price` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `uom` string, nullable — Used to define the unit of measure used to describe the product.
      - `upc` string, nullable — Used to define the 12-digit Universal Product Code (a barcode) associated with the item worldwide.
      - `weight` IWeight
        - `unit` string
        - `weight` number
    - `merchant_order_url` string
    - `order_description` string — Used optionally to pass additional information like order numbers or other IDs as needed.
    - `order_reference` string — This value is used by Bolt as an external reference to a given order. This reference must be unique per successful transaction.
    - `shipments` ICartShipmentView[]
      - `carrier` string — The carrier used to deliver the shipment.
      - `cost` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `default` boolean
      - `description` IDescriptionPart[]
        - `content` string
        - `is_html` boolean
      - `description_tooltips` IDescriptionTooltip[]
        - `html_content` string
        - `target` number
      - `estimated_delivery_date` string, date-time
      - `expedited` boolean — Used to determine whether a shipment has been expedited or not.
      - `gift_options` GiftOptionView — Defines which gift options are hidden.
        - `hide_gift_message` boolean
        - `hide_gift_wrap` boolean
      - `id` string
      - `package_dimension` object
        - `depth` number
        - `height` number
        - `unit` string
        - `width` number
      - `package_type` string
      - `package_weight` IWeight
        - `unit` string
        - `weight` number
      - `reference` string
      - `service` string
      - `shipping_address` AddressView — The address object returned in the response.
        - `company` string — The company name associated with this address.
        - `country` string — The name of the country associated with this address.
        - `country_code` string — The ISO 3166-1 alpha-2 country code associated with this address.
        - `door_code` string, nullable — The building door code or community gate code.
        - `email_address` string, email — An email address.
        - `first_name` string — The given name of the person associated with this address.
        - `id` string — The unique Bolt ID associated with this address.
        - `last_name` string — The surname of the person associated with this address.
        - `locality` string — The city name details associated with this address.
        - `name` string — The given and surname of the person associated with this address.
        - `phone_number` string — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.
        - `postal_code` string — The postal or zip code associated with this address.
        - `priority` 'primary' | 'listed', nullable — The shopper-indicated priority of this address compared to other addresses on their account.
        - `region` string — The region details such as state or province associated with this address.
        - `region_code` string, nullable — The the ISO 3166-2 region code associated with this address.
        - `street_address1` string — The street number and street name of the address.
        - `street_address2` string — Any apartment, floor, or unit details.
        - `street_address3` string, nullable — Any additional street address details.
        - `street_address4` string, nullable — Any additional street address details.
      - `shipping_method` string
      - `signature` string
      - `tax_amount` AmountView
        - `amount` number
        - `currency` string
        - `currency_symbol` string
      - `total_weight` IWeight
        - `unit` string
        - `weight` number
      - `type` string
    - `shipping_amount` AmountView
      - `amount` number
      - `currency` string
      - `currency_symbol` string
    - `subtotal_amount` AmountView
      - `amount` number
      - `currency` string
      - `currency_symbol` string
    - `tax_amount` AmountView
      - `amount` number
      - `currency` string
      - `currency_symbol` string
    - `total_amount` AmountView
      - `amount` number
      - `currency` string
      - `currency_symbol` string
    - `transaction_reference` string — The 12 digit reference ID associated to a given transaction webhook for an order.
  - `dynamic_content` IOrderDynamicContent
    - `custom_fields` ICustomFieldView[]
      - `checkout_step` 'SHIPPING_STEP' | 'DELIVERY_STEP' | 'PAYMENT_STEP' | 'ACCOUNT_REGISTRATION_SSO'
      - `dynamic` boolean
      - `context` 'CHECKOUT' | 'SSO'
      - `external_id` string
      - `field_setup` string
      - `helper_text` string
      - `label` string
      - `position` number
      - `public_id` string
      - `required` boolean
      - `subscribeToNewsletter` boolean
    - `eligible_payment_methods` EligiblePaymentMethod[]
      - `eligible` boolean
      - `transaction_processor_type` 'affirm' | 'afterpay' | 'amazon_pay' | 'credova' | 'klarna' | 'paypal' | 'sezzle' | 'radial_klarna' | 'radial_paypal' | 'adyen_gateway' | 'alliance_data' | 'authorize_net' | 'braintree' | 'cardconnect' | 'checkout_com' | 'cybersource' | 'first_data' | 'nmi' | 'orbital' | 'paypal_payflow' | 'radial' | 'rocketgate' | 'shopify_payments' | 'stripe' | 'magentopayment' | 'adyen_payfac' | 'vantiv' | 'google_pay' | 'bolt'
    - `gift_option_view` IGiftOptionView
      - `hide_gift_message` boolean
      - `hide_gift_wrap` boolean
    - `hide_apm` string[]
    - `order_notice` string
    - `payment_notice` string
    - `shipping_info_notice` string
    - `shipping_notice` string
  - `external_data` IOrderExternalData
    - `steam_id` string
  - `token` string
  - `user_note` string — Used by shoppers to make extra requests or provide details for gift messages.

## Other responses

- `400` — Generic Error Schema
- `403` — Generic Error Schema
- `422` — Generic Error Schema

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/1f62c40558c6/schema)