# Create Order Token

> 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.

Source: https://help.boltapp.com/api-reference/endpoints/orders/createordertoken

`POST /v1/merchant/orders`

## OpenAPI definition

This endpoint as it appears in the OpenAPI document, with every schema it references included.

```json
{
  "openapi": "3.2.0",
  "info": {
    "version": "1.0.1",
    "title": "Bolt API Reference",
    "description": "Postman Collection:\n\n[![](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/9136127-55d2bde1-a248-473f-95b5-64cfd02fb445?action=collection%2Ffork&collection-url=entityId%3D9136127-55d2bde1-a248-473f-95b5-64cfd02fb445%26entityType%3Dcollection%26workspaceId%3D78beee89-4238-4c5f-bd1f-7e98978744b4#?env%5BBolt%20Sandbox%20Environment%5D=W3sia2V5IjoiYXBpX2Jhc2VfdXJsIiwidmFsdWUiOiJodHRwczovL2FwaS1zYW5kYm94LmJvbHQuY29tIiwidHlwZSI6ImRlZmF1bHQiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6InRrX2Jhc2UiLCJ2YWx1ZSI6Imh0dHBzOi8vc2FuZGJveC5ib2x0dGsuY29tIiwidHlwZSI6ImRlZmF1bHQiLCJlbmFibGVkIjp0cnVlfSx7ImtleSI6ImFwaV9rZXkiLCJ2YWx1ZSI6IjxyZXBsYWNlIHdpdGggeW91ciBCb2x0IFNhbmRib3ggQVBJIGtleT4iLCJ0eXBlIjoic2VjcmV0IiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJwdWJsaXNoYWJsZV9rZXkiLCJ2YWx1ZSI6IjxyZXBsYWNlIHdpdGggeW91ciBCb2x0IFNhbmRib3ggcHVibGlzaGFibGUga2V5PiIsInR5cGUiOiJkZWZhdWx0IiwiZW5hYmxlZCI6dHJ1ZX0seyJrZXkiOiJkaXZpc2lvbl9pZCIsInZhbHVlIjoiPHJlcGxhY2Ugd2l0aCB5b3VyIEJvbHQgU2FuZGJveCBwdWJsaWMgZGl2aXNpb24gSUQ+IiwidHlwZSI6ImRlZmF1bHQiLCJlbmFibGVkIjp0cnVlfV0=)\n\n## About\n A comprehensive Bolt API reference for interacting with Transactions, Orders, Product Catalog, Configuration, Testing, and much more.\n\n Note: You must also reference the [Merchant Callback API](/api-merchant) when building a managed checkout custom cart integration\n"
  },
  "servers": [
    {
      "url": "https://api.boltapp.com",
      "description": "The Production URL (Live Data)."
    },
    {
      "url": "https://api-sandbox.boltapp.com",
      "description": "The Sandbox URL (Test Data)."
    },
    {
      "url": "https://api-staging.boltapp.com",
      "description": "The Staging URL (Staged Data)."
    }
  ],
  "security": [
    {
      "X-API-Key": []
    },
    {
      "OAuth": [
        "bolt.account.manage",
        "bolt.account.view"
      ]
    }
  ],
  "paths": {
    "/v1/merchant/orders": {
      "post": {
        "description": "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.",
        "operationId": "createOrderToken",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/order_create"
              }
            }
          },
          "description": "Generate Order Token"
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/i_order_view"
                }
              }
            },
            "description": "Token Generation Successful"
          },
          "400": {
            "$ref": "#/components/responses/order_generate_error_400"
          },
          "403": {
            "$ref": "#/components/responses/order_generate_error_403"
          },
          "422": {
            "$ref": "#/components/responses/order_generate_error_422"
          }
        },
        "security": [
          {
            "X-API-Key": []
          }
        ],
        "summary": "Create Order Token",
        "tags": [
          "Orders"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "order_create": {
        "properties": {
          "cart": {
            "allOf": [
              {
                "$ref": "#/components/schemas/cart_create"
              },
              {
                "description": "The cart_create object is a composite of the base_cart object and additional order details."
              },
              {
                "required": [
                  "order_reference"
                ]
              }
            ]
          },
          "channel": {
            "description": "Used to determine the channel from which the order was created.",
            "enum": [
              "browser",
              "mobile_app"
            ],
            "type": "string"
          },
          "create_cart_on_merchant_backend": {
            "description": "Used to determine whether the order is created on your backend platform. This should almost always be `false`.",
            "type": [
              "boolean",
              "null"
            ],
            "examples": [
              false
            ]
          },
          "metadata": {
            "$ref": "#/components/schemas/i_order_metadata"
          },
          "user_note": {
            "description": "Optionally used by shoppers to make extra requests or provide details for gift messages.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Happy Birthday to my best friend in the whole world. Enjoy!"
            ]
          },
          "seller_splits": {
            "description": "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.",
            "items": {
              "$ref": "#/components/schemas/seller_split"
            },
            "type": [
              "array",
              "null"
            ]
          }
        },
        "required": [
          "cart",
          "channel"
        ],
        "type": "object"
      },
      "cart_create": {
        "allOf": [
          {
            "$ref": "#/components/schemas/base_cart"
          },
          {
            "properties": {
              "cart_url": {
                "description": "Used to provide a link to the cart ID.",
                "maxLength": 8192,
                "type": "string",
                "examples": [
                  "https://boltswagstore.com/orders/123456765432"
                ]
              },
              "currency": {
                "type": "string",
                "examples": [
                  "USD"
                ]
              },
              "display_id": {
                "description": "This field, although required, can be an empty string.",
                "maxLength": 128,
                "type": "string",
                "examples": [
                  "displayid_100"
                ]
              },
              "metadata": {
                "additionalProperties": {
                  "type": "string"
                },
                "description": "Optional custom metadata.",
                "type": "object",
                "examples": [
                  {
                    "key1": "value1",
                    "key2": "value2"
                  }
                ]
              },
              "order_description": {
                "description": "Used optionally to pass additional information like order numbers or other IDs as needed.",
                "maxLength": 1024,
                "type": "string",
                "examples": [
                  "Order #1234567890"
                ]
              },
              "order_reference": {
                "description": "This value is used by Bolt as an external reference to a given order. This reference must be unique per successful transaction.",
                "type": "string",
                "examples": [
                  "order_100"
                ]
              }
            },
            "required": [
              "currency",
              "order_reference"
            ],
            "type": "object"
          }
        ]
      },
      "base_cart": {
        "description": "The base_cart object contains the core details typically found in most cart objects, including items, discounts, amount totals, shipments, and in-store pickups.",
        "properties": {
          "add_ons": {
            "items": {
              "$ref": "#/components/schemas/cart_add_on"
            },
            "type": "array"
          },
          "billing_address": {
            "$ref": "#/components/schemas/address"
          },
          "discounts": {
            "items": {
              "$ref": "#/components/schemas/cart_discount"
            },
            "type": "array"
          },
          "fees": {
            "items": {
              "$ref": "#/components/schemas/cart_fee"
            },
            "type": "array"
          },
          "fulfillments": {
            "items": {
              "$ref": "#/components/schemas/fulfillment"
            },
            "type": "array"
          },
          "in_store_cart_shipments": {
            "items": {
              "$ref": "#/components/schemas/in_store_cart_shipment"
            },
            "type": "array"
          },
          "items": {
            "description": "The list of items associated with the cart.",
            "items": {
              "$ref": "#/components/schemas/cart_item"
            },
            "type": "array"
          },
          "loyalty_rewards": {
            "items": {
              "$ref": "#/components/schemas/cart_loyalty_rewards"
            },
            "type": "array"
          },
          "shipments": {
            "items": {
              "$ref": "#/components/schemas/cart_shipment"
            },
            "type": "array"
          },
          "tax_amount": {
            "description": "The total tax amount for all of the items associated with the cart.",
            "format": "int64",
            "type": "number"
          },
          "total_amount": {
            "description": "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.",
            "format": "int64",
            "type": "number",
            "examples": [
              900
            ]
          }
        },
        "required": [
          "total_amount"
        ],
        "type": "object"
      },
      "cart_add_on": {
        "description": "A list of up to 3 add-ons that are displayed to the shopper.",
        "properties": {
          "description": {
            "description": "The description of the product being displayed as an add on.",
            "maxLength": 256,
            "type": "string"
          },
          "imageUrl": {
            "description": "The URL of the image displayed for the add on product.",
            "maxLength": 1024,
            "type": "string"
          },
          "name": {
            "description": "The name of the product being displayed as an add on.",
            "maxLength": 256,
            "type": "string"
          },
          "price": {
            "description": "The price of the product add on in cents (1/100).",
            "format": "int64",
            "type": "number"
          },
          "productId": {
            "description": "The the ID of the product being displayed as an add on.",
            "maxLength": 256,
            "type": "string"
          },
          "productPageUrl": {
            "description": "The URL to the product page of the product being displayed as an add on.",
            "maxLength": 1024,
            "type": "string"
          }
        },
        "required": [
          "name",
          "productId",
          "price"
        ],
        "type": "object"
      },
      "address": {
        "description": "The Address object is used for billing, shipping, and physical store address use cases.",
        "properties": {
          "company": {
            "description": "The company name associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Bolt"
            ]
          },
          "country": {
            "description": "The name of the country associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "United States"
            ]
          },
          "country_code": {
            "description": "The ISO 3166-1 alpha-2 country code associated with this address.",
            "maxLength": 2,
            "minLength": 2,
            "type": "string",
            "examples": [
              "US"
            ]
          },
          "default": {
            "description": "Whether the added address is now the default address.",
            "type": "boolean",
            "examples": [
              true
            ]
          },
          "door_code": {
            "$ref": "#/components/schemas/door_code"
          },
          "email": {
            "description": "The email address associated with this address.",
            "$ref": "#/components/schemas/email"
          },
          "first_name": {
            "description": "The given name of the person associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Alan"
            ]
          },
          "last_name": {
            "description": "The surname of the person associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Watts"
            ]
          },
          "locality": {
            "description": "The city name details associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Brooklyn"
            ]
          },
          "name": {
            "description": "The given and surname of the person associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Alan Watts"
            ]
          },
          "phone": {
            "description": "The phone number associated with this address.",
            "$ref": "#/components/schemas/phone"
          },
          "postal_code": {
            "description": "The the postal or zip code associated with this address.",
            "maxLength": 32,
            "type": "string",
            "examples": [
              "10044"
            ]
          },
          "region": {
            "description": "**Not Required for NON US addresses**. The region details such as state or province associated with this address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "NY"
            ]
          },
          "region_code": {
            "description": "The ISO 3166-2 region code associated with this address.\n  - * If specified, value must be valid for the `country`.\n  - * If null, value is inferred from the `region`.\n",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "NY"
            ]
          },
          "street_address1": {
            "description": "The street number and street name of the address.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "888 main street"
            ]
          },
          "street_address2": {
            "description": "Any apartment, floor, or unit details.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "apt 3021"
            ]
          },
          "street_address3": {
            "description": "Any additional street address details.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "c/o Alicia Watts"
            ]
          },
          "street_address4": {
            "description": "Any additional street address details.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Bridge Street Apartment Building B"
            ]
          }
        },
        "required": [
          "street_address1",
          "locality",
          "region",
          "country_code",
          "postal_code",
          "email",
          "first_name",
          "last_name"
        ],
        "type": "object"
      },
      "door_code": {
        "description": "The building door code or community gate code.",
        "maxLength": 1024,
        "type": [
          "string",
          "null"
        ],
        "examples": [
          "123456"
        ]
      },
      "email": {
        "description": "An email address.",
        "format": "email",
        "type": "string",
        "maxLength": 255,
        "examples": [
          "alan.watts@example.com"
        ]
      },
      "phone": {
        "description": "A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign.",
        "maxLength": 16,
        "type": "string",
        "examples": [
          "+12125550199"
        ]
      },
      "cart_discount": {
        "properties": {
          "amount": {
            "type": "number",
            "examples": [
              100
            ]
          },
          "code": {
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "SUMMER10DISCOUNT"
            ]
          },
          "description": {
            "description": "Used to define the discount offering.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "10% off our summer collection"
            ]
          },
          "details_url": {
            "description": "Used to provide a link to additional details, such as a landing page, associated with the discount offering.",
            "maxLength": 8192,
            "type": "string",
            "examples": [
              "https://boltswagstore.com/SUMMERSALE"
            ]
          },
          "discount_category": {
            "enum": [
              "coupon",
              "giftcard",
              "managed_giftcard",
              "store_credit",
              "automatic_promotion",
              "membership_discount",
              "membership_giftcard",
              "subscription_discount",
              "rewards_discount",
              "shipping_discount",
              "unknown"
            ],
            "type": "string"
          },
          "reference": {
            "description": "Used to define the reference ID associated with the discount available.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "DISC-1234"
            ]
          },
          "type": {
            "description": "The type of discount.",
            "enum": [
              "fixed_amount",
              "percentage",
              "free_shipping"
            ],
            "type": "string",
            "examples": [
              "percentage"
            ]
          }
        },
        "type": "object"
      },
      "cart_fee": {
        "properties": {
          "reference": {
            "description": "Unique reference used to identify the fee.",
            "maxLength": 1024,
            "nullable": false,
            "type": "string",
            "examples": [
              "ItemFee"
            ]
          },
          "name": {
            "description": "Name of the fee that will appear in the order ledger.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Item Fee"
            ]
          },
          "description": {
            "description": "Description of the fee that will appear in the tooltip if the mouse hovers over the fee.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Item Fee"
            ]
          },
          "unit_price": {
            "format": "int64",
            "nullable": false,
            "type": "number"
          },
          "unit_tax_amount": {
            "format": "int64",
            "nullable": false,
            "type": "number"
          },
          "quantity": {
            "format": "int64",
            "nullable": false,
            "type": "number"
          }
        },
        "required": [
          "reference",
          "name",
          "unit_price",
          "unit_tax_amount",
          "quantity"
        ],
        "type": "object"
      },
      "fulfillment": {
        "description": "Defines the shipments associated with the cart items.",
        "properties": {
          "cart_items": {
            "items": {
              "$ref": "#/components/schemas/cart_item"
            },
            "type": "array"
          },
          "cart_shipment": {
            "$ref": "#/components/schemas/cart_shipment"
          },
          "digital_delivery": {
            "$ref": "#/components/schemas/digital_delivery"
          },
          "in_store_cart_shipment": {
            "$ref": "#/components/schemas/in_store_cart_shipment"
          },
          "type": {
            "enum": [
              "physical_door_delivery",
              "physical_ship_to_store",
              "physical_in_store_pickup",
              "digital_download",
              "digital_no_delivery"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "cart_item": {
        "properties": {
          "brand": {
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Bolt"
            ]
          },
          "category": {
            "description": "Used to define a product category associated with the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "bags"
            ]
          },
          "collections": {
            "$ref": "#/components/schemas/collections"
          },
          "color": {
            "description": "Used to define the color of the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Bolt Blue"
            ]
          },
          "customizations": {
            "items": {
              "$ref": "#/components/schemas/cart_item_customization"
            },
            "type": "array"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Large tote with Bolt logo."
            ]
          },
          "details_url": {
            "description": "Used to provide a link to the item's product page.",
            "maxLength": 8192,
            "type": "string",
            "examples": [
              "https://boltswagstore.com/products/123456"
            ]
          },
          "external_inputs": {
            "$ref": "#/components/schemas/i_cart_item_external_inputs"
          },
          "gift_option": {
            "$ref": "#/components/schemas/cart_item_gift_option"
          },
          "image_url": {
            "description": "Used to provide a link to the image associated with the item.",
            "maxLength": 8192,
            "type": "string",
            "examples": [
              "https://boltswagstore.com/products/123456/images/1.png"
            ]
          },
          "isbn": {
            "description": "Used to define the International Standard Book Number associated with the book.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "9780091347314"
            ]
          },
          "item_group": {
            "type": [
              "string",
              "null"
            ]
          },
          "manufacturer": {
            "description": "Used to define the organization that manufactured the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Bolt Textiles USA"
            ]
          },
          "merchant_product_id": {
            "$ref": "#/components/schemas/merchant_product_id"
          },
          "merchant_variant_id": {
            "$ref": "#/components/schemas/merchant_variant_id"
          },
          "msrp": {
            "format": "int64",
            "type": [
              "number",
              "null"
            ]
          },
          "name": {
            "maxLength": 1024,
            "minLength": 1,
            "type": "string",
            "examples": [
              "Bolt Swag Bag"
            ]
          },
          "options": {
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Special Edition"
            ]
          },
          "properties": {
            "items": {
              "$ref": "#/components/schemas/cart_item_property"
            },
            "type": "array"
          },
          "quantity": {
            "format": "int64",
            "maximum": 15000,
            "type": "number",
            "examples": [
              1
            ]
          },
          "reference": {
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "item_100"
            ]
          },
          "shipment": {
            "$ref": "#/components/schemas/cart_shipment"
          },
          "shipment_type": {
            "enum": [
              "unknown",
              "door_delivery",
              "ship_to_store",
              "in_store_pickup"
            ],
            "type": "string"
          },
          "size": {
            "description": "Used to define the size of the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Large"
            ]
          },
          "sku": {
            "description": "Used to define the alpha-numberic Stock Keeping Unit associated with the item as it is mapped to your internal product catalogue.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "BOLT-SKU_100"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "seller_id": {
            "description": "The unique identifier for the seller within the marketplace ecosystem. This field ensures deterministic multi-party payout calculations.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "seller-1234"
            ]
          },
          "tags": {
            "description": "Used to define a comma-separated list of tags associated with the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "tote, blue, linen, eco-friendly"
            ]
          },
          "tax_amount": {
            "description": "The tax amount for the item; this value should scale with the quantity of units selected.",
            "format": "int64",
            "type": [
              "number",
              "null"
            ],
            "examples": [
              0
            ]
          },
          "tax_code": {
            "maxLength": 32,
            "type": [
              "string",
              "null"
            ]
          },
          "taxable": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "total_amount": {
            "description": "The total amount, in cents, of the item including its taxes if applicable.",
            "format": "int64",
            "type": "number",
            "examples": [
              1000
            ]
          },
          "type": {
            "enum": [
              "unknown",
              "digital",
              "physical",
              "bundled"
            ],
            "type": "string"
          },
          "unit_price": {
            "description": "The price of one unit of the item; for example, the price of one pack of socks.",
            "format": "int64",
            "type": "number",
            "examples": [
              1000
            ]
          },
          "uom": {
            "description": "Used to define the unit of measure used to describe the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "inches"
            ]
          },
          "upc": {
            "description": "Used to define the 12-digit Universal Product Code (a barcode) associated with the item worldwide.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "0825764603119"
            ]
          },
          "weight": {
            "format": "int64",
            "maximum": 10000,
            "type": [
              "number",
              "null"
            ],
            "examples": [
              10
            ]
          },
          "weight_unit": {
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "pounds"
            ]
          }
        },
        "required": [
          "reference",
          "name",
          "total_amount",
          "unit_price",
          "quantity"
        ],
        "type": "object"
      },
      "collections": {
        "items": {
          "$ref": "#/components/schemas/collection"
        },
        "type": "array"
      },
      "collection": {
        "type": "string",
        "examples": [
          "summer"
        ]
      },
      "cart_item_customization": {
        "properties": {
          "attributes": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "examples": [
              {
                "key1": "value1",
                "key2": "value2"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "price": {
            "format": "int64",
            "type": "number",
            "examples": [
              754
            ]
          }
        },
        "type": "object"
      },
      "i_cart_item_external_inputs": {
        "properties": {
          "shopify_line_item_reference": {
            "format": "int64",
            "type": "number"
          },
          "shopify_product_reference": {
            "format": "int64",
            "type": "number"
          },
          "shopify_product_variant_reference": {
            "format": "int64",
            "type": "number"
          }
        },
        "type": "object"
      },
      "cart_item_gift_option": {
        "description": "Contains the gift option settings for wrapping and custom messages.",
        "properties": {
          "cost": {
            "$ref": "#/components/schemas/cost"
          },
          "merchant_product_id": {
            "$ref": "#/components/schemas/merchant_product_id"
          },
          "message": {
            "$ref": "#/components/schemas/gift_options_message"
          },
          "wrap": {
            "$ref": "#/components/schemas/gift_options_wrap"
          }
        },
        "type": "object"
      },
      "cost": {
        "description": "The cost in cents.",
        "type": "integer",
        "examples": [
          770
        ]
      },
      "merchant_product_id": {
        "description": "The merchant's unique ID for the product.",
        "type": "string",
        "examples": [
          "881"
        ]
      },
      "gift_options_message": {
        "description": "Includes the gift message written by the shopper.",
        "type": "string",
        "examples": [
          "Happy Anniversary, Smoochy Poo!"
        ]
      },
      "gift_options_wrap": {
        "description": "Defines whether gift wrapping was requested.",
        "type": "boolean",
        "examples": [
          false
        ]
      },
      "merchant_variant_id": {
        "description": "A merchant's unique ID for a given product's specific variant.",
        "type": "string",
        "examples": [
          "888"
        ]
      },
      "cart_item_property": {
        "properties": {
          "color": {
            "maxLength": 1024,
            "type": "string"
          },
          "display": {
            "type": "boolean"
          },
          "name": {
            "maxLength": 1024,
            "type": "string"
          },
          "name_id": {
            "format": "int64",
            "type": "number"
          },
          "value": {
            "maxLength": 1024,
            "type": "string"
          },
          "value_id": {
            "format": "int64",
            "type": "number"
          }
        },
        "type": "object"
      },
      "cart_shipment": {
        "description": "A cart that is being prepared for shipment",
        "properties": {
          "carrier": {
            "$ref": "#/components/schemas/carrier"
          },
          "cost": {
            "$ref": "#/components/schemas/cost"
          },
          "discounted_by_membership": {
            "$ref": "#/components/schemas/discount_membership"
          },
          "estimated_delivery_date": {
            "$ref": "#/components/schemas/estimated_delivery_date"
          },
          "expedited": {
            "$ref": "#/components/schemas/expedited"
          },
          "package_depth": {
            "$ref": "#/components/schemas/depth"
          },
          "package_dimension_unit": {
            "$ref": "#/components/schemas/dimension_unit"
          },
          "package_height": {
            "$ref": "#/components/schemas/height"
          },
          "package_type": {
            "$ref": "#/components/schemas/package_type"
          },
          "package_weight_unit": {
            "$ref": "#/components/schemas/weight_unit"
          },
          "package_width": {
            "$ref": "#/components/schemas/width"
          },
          "service": {
            "$ref": "#/components/schemas/service"
          },
          "shipping_address": {
            "$ref": "#/components/schemas/address"
          },
          "shipping_address_id": {
            "$ref": "#/components/schemas/shipping_address_id"
          },
          "shipping_method": {
            "$ref": "#/components/schemas/shipping_method"
          },
          "signature": {
            "$ref": "#/components/schemas/signature"
          },
          "tax_amount": {
            "$ref": "#/components/schemas/tax_amount"
          },
          "tax_code": {
            "$ref": "#/components/schemas/tax_code"
          },
          "total_weight": {
            "description": "The total weight.",
            "type": "integer",
            "examples": [
              55
            ]
          },
          "total_weight_unit": {
            "$ref": "#/components/schemas/weight_unit"
          },
          "type": {
            "$ref": "#/components/schemas/cart_shipment_type"
          }
        },
        "type": "object"
      },
      "carrier": {
        "description": "The name of the carrier selected.",
        "type": "string",
        "examples": [
          "FedEx"
        ]
      },
      "discount_membership": {
        "description": "Defines if shopper has a membership discount.",
        "type": "boolean",
        "examples": [
          false
        ]
      },
      "estimated_delivery_date": {
        "description": "The estimated delivery date.",
        "type": "string",
        "examples": [
          "08-30-2022"
        ]
      },
      "expedited": {
        "description": "True if shipment is expedited.",
        "type": "boolean",
        "examples": [
          false
        ]
      },
      "depth": {
        "description": "The depth.",
        "type": "integer",
        "examples": [
          90
        ]
      },
      "dimension_unit": {
        "description": "The unit of measurement for an item's dimensions.",
        "type": "string",
        "examples": [
          "cm"
        ]
      },
      "height": {
        "description": "The height.",
        "type": "integer",
        "examples": [
          103
        ]
      },
      "package_type": {
        "description": "The type of package.",
        "type": "string",
        "examples": [
          "A big package."
        ]
      },
      "weight_unit": {
        "description": "The unit of measurement for an item's weight.",
        "type": "string",
        "examples": [
          "kg"
        ]
      },
      "width": {
        "description": "The width.",
        "type": "integer",
        "examples": [
          222
        ]
      },
      "service": {
        "description": "The service name.",
        "type": "string",
        "examples": [
          "Option 1"
        ]
      },
      "shipping_address_id": {
        "description": "ID for billing address",
        "type": "string",
        "examples": [
          "address1"
        ]
      },
      "shipping_method": {
        "description": "The name of the shipping method.",
        "type": "string",
        "examples": [
          "unknown"
        ]
      },
      "signature": {
        "description": "The signature.",
        "type": "string",
        "examples": [
          "a1B2s3dC4f5g5D6hj6E7k8F9l0"
        ]
      },
      "tax_amount": {
        "description": "Tax amount in cents.",
        "type": "integer",
        "examples": [
          230
        ]
      },
      "tax_code": {
        "description": "The relevant tax code.",
        "type": "string",
        "examples": [
          "tax-12345"
        ]
      },
      "cart_shipment_type": {
        "description": "The type corresponding to this shipment, if applicable.",
        "enum": [
          "door_delivery",
          "in_store_pickup",
          "ship_to_store",
          "ship_to_home_only",
          "unknown"
        ],
        "type": "string",
        "examples": [
          "door_delivery"
        ]
      },
      "digital_delivery": {
        "properties": {
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "in_store_cart_shipment": {
        "properties": {
          "cart_shipment": {
            "$ref": "#/components/schemas/cart_shipment"
          },
          "description": {
            "description": "Shipment option description.",
            "type": "string",
            "examples": [
              "Pick up in-store at 123 Main St."
            ]
          },
          "distance": {
            "format": "float64",
            "type": "number",
            "examples": [
              3
            ]
          },
          "distance_unit": {
            "enum": [
              "km",
              "mile"
            ],
            "type": "string",
            "examples": [
              "mile"
            ]
          },
          "in_store_pickup_address": {
            "$ref": "#/components/schemas/address"
          },
          "pickup_window_close": {
            "format": "date",
            "type": "integer"
          },
          "pickup_window_open": {
            "format": "date",
            "type": "integer"
          },
          "store_name": {
            "description": "The local store's name where the item can be picked up.",
            "type": "string",
            "examples": [
              "Bolt Collective"
            ]
          }
        },
        "type": "object"
      },
      "cart_loyalty_rewards": {
        "properties": {
          "amount": {
            "description": "The reward amount in cents (1/100).",
            "format": "int64",
            "type": "number"
          },
          "coupon_code": {
            "description": "The loyalty reward's coupon code.",
            "type": "string"
          },
          "description": {
            "description": "A description of the loyalty reward that will be shown to the shopper.",
            "type": "string",
            "examples": [
              "$5 off (100 Points)"
            ]
          },
          "details": {
            "description": "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.",
            "type": "string",
            "examples": [
              "{\"id\": 123456, \"icon\": \"fa-dollar\", \"name\": \"$15.00 Off\", \"type\": \"Coupon\", \"amount\": 100, \"duration\": \"single_use\", \"cost_text\": \"150 Points\", \"description\": \"Get $15 off your next purchase for 150 points\", \"discount_type\": \"fixed_amount\", \"unrendered_name\": \"$15.00 Off\", \"discount_percentage\": null, \"discount_rate_cents\": null, \"discount_value_cents\": null, \"discount_amount_cents\": 1500, \"unrendered_description\": \"Get $15 off your next purchase for 150 points\", \"applies_to_product_type\": \"ALL\"}"
            ]
          },
          "points": {
            "description": "The number of points needed for this reward.",
            "format": "int64",
            "type": "number"
          },
          "source": {
            "description": "The loyalty rewards provider.",
            "type": "string"
          },
          "type": {
            "description": "The type of loyalty reward.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "i_order_metadata": {
        "properties": {
          "encrypted_user_id": {
            "type": "string",
            "examples": [
              "ID12345678"
            ]
          }
        },
        "type": [
          "object",
          "null"
        ]
      },
      "seller_split": {
        "description": "Defines a seller split configuration for marketplace orders, specifying which items and shipments belong to a seller and how amounts should be calculated and distributed.",
        "properties": {
          "seller_id": {
            "description": "The unique identifier for the seller within the marketplace ecosystem.",
            "type": "string",
            "examples": [
              "seller-1234"
            ]
          },
          "amounts": {
            "$ref": "#/components/schemas/seller_split_amounts",
            "description": "The declarative amounts for this seller split."
          },
          "marketplace_commission_fee": {
            "$ref": "#/components/schemas/marketplace_commission_fee",
            "description": "The marketplace commission fee structure for this seller split."
          }
        },
        "required": [
          "seller_id",
          "amounts",
          "marketplace_commission_fee"
        ],
        "type": "object"
      },
      "seller_split_amounts": {
        "description": "Defines the financial breakdown for a seller split, including subtotals, discounts, shipping, taxes, and the final gross amount.",
        "properties": {
          "merchant_subtotal": {
            "description": "The subtotal amount for the merchant's items in this split, in cents.",
            "format": "int64",
            "type": "number",
            "examples": [
              5000
            ]
          },
          "discount_total": {
            "description": "The total discount amount applied to this seller split, in cents.",
            "format": "int64",
            "type": "number",
            "examples": [
              500
            ]
          },
          "shipping_total": {
            "description": "The total shipping amount for this seller split, in cents.",
            "format": "int64",
            "type": "number",
            "examples": [
              1000
            ]
          },
          "tax_total": {
            "description": "The total tax amount for this seller split, in cents.",
            "format": "int64",
            "type": "number",
            "examples": [
              400
            ]
          },
          "gross_total": {
            "description": "The gross total amount for this seller split, in cents.",
            "format": "int64",
            "type": "number",
            "examples": [
              5900
            ]
          }
        },
        "required": [
          "merchant_subtotal",
          "discount_total",
          "shipping_total",
          "tax_total",
          "gross_total"
        ],
        "type": "object"
      },
      "marketplace_commission_fee": {
        "description": "Configures the marketplace commission fee structure for a seller split, supporting both percentage-based and flat fee models.",
        "properties": {
          "bps": {
            "description": "The commission fee expressed in basis points (1 bps = 0.01%). For example, 100 bps = 1%, 250 bps = 2.5%.",
            "format": "int64",
            "type": "number",
            "examples": [
              250
            ]
          },
          "flat_cents": {
            "description": "The fixed commission fee amount in cents, applied regardless of transaction value.",
            "format": "int64",
            "type": "number",
            "examples": [
              100
            ]
          },
          "metadata": {
            "description": "Additional contextual information about the commission fee, such as plan type, tier level, or other business rules.",
            "additionalProperties": {
              "type": "string"
            },
            "type": [
              "object",
              "null"
            ],
            "examples": [
              {
                "plan_type": "pro",
                "tier": "premium"
              }
            ]
          }
        },
        "required": [
          "bps",
          "flat_cents"
        ],
        "type": "object"
      },
      "i_order_view": {
        "properties": {
          "cart": {
            "$ref": "#/components/schemas/i_cart_view"
          },
          "dynamic_content": {
            "$ref": "#/components/schemas/i_order_dynamic_content"
          },
          "external_data": {
            "$ref": "#/components/schemas/i_order_external_data"
          },
          "token": {
            "type": "string"
          },
          "user_note": {
            "description": "Used by shoppers to make extra requests or provide details for gift messages.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "i_cart_view": {
        "description": "This is the cart object returned in a successful response.",
        "properties": {
          "billing_address": {
            "$ref": "#/components/schemas/address_view"
          },
          "cart_url": {
            "description": "Used to provide a link to the cart ID.",
            "maxLength": 8192,
            "type": "string",
            "examples": [
              "https://boltswagstore.com/orders/123456765432"
            ]
          },
          "currency": {
            "$ref": "#/components/schemas/i_currency"
          },
          "discount_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "discounts": {
            "items": {
              "$ref": "#/components/schemas/i_cart_discount_view"
            },
            "type": "array"
          },
          "display_id": {
            "type": "string",
            "examples": [
              "displayid_100"
            ]
          },
          "fee_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "fees": {
            "items": {
              "$ref": "#/components/schemas/i_cart_fee_view"
            },
            "type": "array"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/i_cart_item_view"
            },
            "type": "array"
          },
          "merchant_order_url": {
            "type": "string"
          },
          "order_description": {
            "description": "Used optionally to pass additional information like order numbers or other IDs as needed.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "Order #1234567890"
            ]
          },
          "order_reference": {
            "description": "This value is used by Bolt as an external reference to a given order. This reference must be unique per successful transaction.",
            "type": "string",
            "examples": [
              "order_100"
            ]
          },
          "shipments": {
            "items": {
              "$ref": "#/components/schemas/i_cart_shipment_view"
            },
            "type": "array"
          },
          "shipping_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "subtotal_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "tax_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "total_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "transaction_reference": {
            "description": "The 12 digit reference ID associated to a given transaction webhook for an order.",
            "maxLength": 12,
            "minLength": 12,
            "type": "string",
            "examples": [
              "6CEA-ZME1-DACE"
            ]
          }
        },
        "type": "object"
      },
      "address_view": {
        "description": "The address object returned in the response.",
        "properties": {
          "company": {
            "description": "The company name associated with this address.",
            "type": "string",
            "examples": [
              "Bolt"
            ]
          },
          "country": {
            "description": "The name of the country associated with this address.",
            "type": "string",
            "examples": [
              "United States"
            ]
          },
          "country_code": {
            "description": "The ISO 3166-1 alpha-2 country code associated with this address.",
            "type": "string",
            "examples": [
              "US"
            ]
          },
          "door_code": {
            "$ref": "#/components/schemas/door_code"
          },
          "email_address": {
            "description": "The email address associated with this address.",
            "$ref": "#/components/schemas/email"
          },
          "first_name": {
            "description": "The given name of the person associated with this address.",
            "type": "string",
            "examples": [
              "Alan"
            ]
          },
          "id": {
            "description": "The unique Bolt ID associated with this address.",
            "type": "string"
          },
          "last_name": {
            "description": "The surname of the person associated with this address.",
            "type": "string",
            "examples": [
              "Watts"
            ]
          },
          "locality": {
            "description": "The city name details associated with this address.",
            "type": "string",
            "examples": [
              "Brooklyn"
            ]
          },
          "name": {
            "description": "The given and surname of the person associated with this address.",
            "type": "string",
            "examples": [
              "Alan Watts"
            ]
          },
          "phone_number": {
            "description": "The phone number associated with this address.",
            "$ref": "#/components/schemas/phone"
          },
          "postal_code": {
            "description": "The postal or zip code associated with this address.",
            "maxLength": 32,
            "type": "string",
            "examples": [
              "10044"
            ]
          },
          "priority": {
            "description": "The shopper-indicated priority of this address compared to other addresses on their account.",
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "primary",
              "listed"
            ],
            "examples": [
              "primary"
            ]
          },
          "region": {
            "description": "The region details such as state or province associated with this address.",
            "type": "string",
            "examples": [
              "NY"
            ]
          },
          "region_code": {
            "description": "The the ISO 3166-2 region code associated with this address.",
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "NY"
            ]
          },
          "street_address1": {
            "description": "The street number and street name of the address.",
            "type": "string",
            "examples": [
              "888 main street"
            ]
          },
          "street_address2": {
            "description": "Any apartment, floor, or unit details.",
            "type": "string",
            "examples": [
              "apt 3021"
            ]
          },
          "street_address3": {
            "description": "Any additional street address details.",
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "c/o Alicia Watts"
            ]
          },
          "street_address4": {
            "description": "Any additional street address details.",
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Bridge Street Apartment Building B"
            ]
          }
        },
        "type": "object"
      },
      "i_currency": {
        "properties": {
          "currency": {
            "type": "string",
            "examples": [
              "USD"
            ]
          },
          "currency_symbol": {
            "type": "string",
            "examples": [
              "$"
            ]
          }
        },
        "type": "object"
      },
      "amount_view": {
        "properties": {
          "amount": {
            "format": "int64",
            "type": "number",
            "examples": [
              754
            ]
          },
          "currency": {
            "type": "string",
            "examples": [
              "USD"
            ]
          },
          "currency_symbol": {
            "type": "string",
            "examples": [
              "$"
            ]
          }
        },
        "type": "object"
      },
      "i_cart_discount_view": {
        "properties": {
          "amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "code": {
            "description": "Discount code used.",
            "type": "string",
            "examples": [
              "SUMMER10"
            ]
          },
          "description": {
            "description": "Used to define the discount offering.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "10% off our summer collection"
            ]
          },
          "details_url": {
            "description": "Used to provide a link to additional details, such as a landing page, associated with the discount offering.",
            "type": "string",
            "examples": [
              "https://boltswagstore.com/SUMMERSALE"
            ]
          },
          "discount_category": {
            "enum": [
              "coupon",
              "giftcard",
              "managed_giftcard",
              "store_credit",
              "automatic_promotion",
              "membership_discount",
              "membership_giftcard",
              "subscription_discount",
              "rewards_discount",
              "shipping_discount",
              "unknown"
            ],
            "type": "string"
          },
          "free_shipping": {
            "$ref": "#/components/schemas/i_free_shipping_discount_view"
          },
          "reference": {
            "description": "Used to define the reference ID associated with the discount available.",
            "type": "string",
            "examples": [
              "DISC-1234"
            ]
          }
        },
        "type": "object"
      },
      "i_free_shipping_discount_view": {
        "properties": {
          "is_free_shipping": {
            "type": "boolean"
          },
          "maximum_cost_allowed": {
            "format": "int64",
            "type": "number"
          }
        },
        "type": "object"
      },
      "i_cart_fee_view": {
        "properties": {
          "reference": {
            "description": "Unique reference used to identify the fee.",
            "maxLength": 1024,
            "nullable": false,
            "type": "string",
            "examples": [
              "ItemFee"
            ]
          },
          "name": {
            "description": "Name of the fee that will appear in the order ledger.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Item Fee"
            ]
          },
          "description": {
            "description": "Description of the fee that will appear in the tooltip if the mouse hovers over the fee.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Item Fee"
            ]
          },
          "unit_price": {
            "$ref": "#/components/schemas/amount_view"
          },
          "unit_tax_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "quantity": {
            "format": "int64",
            "nullable": false,
            "type": "number"
          }
        },
        "type": "object"
      },
      "i_cart_item_view": {
        "properties": {
          "bolt_product_id": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "category": {
            "description": "Used to define a product category associated with the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "bags"
            ]
          },
          "collections": {
            "$ref": "#/components/schemas/collections"
          },
          "color": {
            "description": "Used to define the color of the item.",
            "type": "string",
            "examples": [
              "Bolt Blue"
            ]
          },
          "customizations": {
            "items": {
              "$ref": "#/components/schemas/cart_item_customization"
            },
            "type": "array"
          },
          "description": {
            "type": "string"
          },
          "details_url": {
            "description": "Used to provide a link to the item's product page.",
            "type": "string",
            "examples": [
              "https://boltswagstore.com/products/123456"
            ]
          },
          "gift_option": {
            "$ref": "#/components/schemas/gift_option_view"
          },
          "hide": {
            "type": "boolean"
          },
          "image_url": {
            "description": "Used to provide a link to the image associated with the item.",
            "type": "string",
            "examples": [
              "https://boltswagstore.com/products/123456/images/1.png"
            ]
          },
          "isbn": {
            "description": "Used to define the International Standard Book Number associated with the book.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              9780091347314
            ]
          },
          "item_group": {
            "type": "string"
          },
          "manufacturer": {
            "description": "Used to define the organization that manufactured the item.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Bolt Textiles USA"
            ]
          },
          "merchant_product_id": {
            "type": "string"
          },
          "merchant_variant_id": {
            "type": "string"
          },
          "msrp": {
            "$ref": "#/components/schemas/amount_view"
          },
          "name": {
            "type": "string"
          },
          "options": {
            "type": "string"
          },
          "properties": {
            "items": {
              "$ref": "#/components/schemas/cart_item_property_view"
            },
            "type": "array"
          },
          "quantity": {
            "format": "int64",
            "type": "number",
            "examples": [
              1
            ]
          },
          "reference": {
            "type": "string"
          },
          "shipment_id": {
            "type": "string"
          },
          "shipment_type": {
            "enum": [
              "unknown",
              "door_delivery",
              "ship_to_store",
              "in_store_pickup",
              "ship_to_home_only"
            ],
            "type": "string"
          },
          "shopify_line_item_reference": {
            "format": "int64",
            "type": "number"
          },
          "shopify_product_reference": {
            "format": "int64",
            "type": "number"
          },
          "shopify_product_variant_reference": {
            "format": "int64",
            "type": "number"
          },
          "size": {
            "description": "Used to define the size of the item.",
            "type": "string",
            "examples": [
              "Large"
            ]
          },
          "sku": {
            "description": "Used to define an alpha-numeric Stock Keeping Unit associated with the item as it is mapped to your internal product catalogue.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "BOLT-SKU_100"
            ]
          },
          "subscription": {
            "$ref": "#/components/schemas/subscription"
          },
          "tags": {
            "description": "Used to define a comma-separated list of tags associated with the item.",
            "type": "string",
            "examples": [
              "tote, blue, linen, eco-friendly"
            ]
          },
          "tax_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "taxable": {
            "type": "boolean"
          },
          "total_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "type": {
            "enum": [
              "unknown",
              "digital",
              "physical",
              "bundled"
            ],
            "type": "string"
          },
          "unit_price": {
            "$ref": "#/components/schemas/amount_view"
          },
          "uom": {
            "description": "Used to define the unit of measure used to describe the product.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "inches"
            ]
          },
          "upc": {
            "description": "Used to define the 12-digit Universal Product Code (a barcode) associated with the item worldwide.",
            "maxLength": 1024,
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "0825764603119"
            ]
          },
          "weight": {
            "$ref": "#/components/schemas/i_weight"
          }
        },
        "type": "object"
      },
      "gift_option_view": {
        "description": "Defines which gift options are hidden.",
        "properties": {
          "hide_gift_message": {
            "type": "boolean",
            "examples": [
              false
            ]
          },
          "hide_gift_wrap": {
            "type": "boolean",
            "examples": [
              false
            ]
          }
        },
        "type": "object"
      },
      "cart_item_property_view": {
        "properties": {
          "color": {
            "type": "string"
          },
          "display": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "subscription": {
        "description": "Describes a product added as a recurring subscription.",
        "properties": {
          "frequency": {
            "description": "Describes how often the subscription recurs.",
            "properties": {
              "unit": {
                "description": "The unit for this subscription's frequency.",
                "enum": [
                  "day",
                  "week",
                  "month",
                  "year"
                ],
                "type": "string",
                "examples": [
                  "month"
                ]
              },
              "value": {
                "description": "The value applied to the unit frequency.",
                "type": "integer",
                "examples": [
                  2
                ]
              }
            },
            "type": "object"
          }
        },
        "type": "object"
      },
      "i_weight": {
        "properties": {
          "unit": {
            "type": "string"
          },
          "weight": {
            "format": "int64",
            "type": "number"
          }
        },
        "type": "object"
      },
      "i_cart_shipment_view": {
        "properties": {
          "carrier": {
            "description": "The carrier used to deliver the shipment.",
            "maxLength": 1024,
            "type": "string",
            "examples": [
              "USPS"
            ]
          },
          "cost": {
            "$ref": "#/components/schemas/amount_view"
          },
          "default": {
            "type": "boolean"
          },
          "description": {
            "items": {
              "$ref": "#/components/schemas/i_description_part"
            },
            "type": "array"
          },
          "description_tooltips": {
            "items": {
              "$ref": "#/components/schemas/i_description_tooltip"
            },
            "type": "array"
          },
          "estimated_delivery_date": {
            "format": "date-time",
            "type": "string",
            "examples": [
              "2022-04-10 16:12:38.386000+00:00"
            ]
          },
          "expedited": {
            "description": "Used to determine whether a shipment has been expedited or not.",
            "type": "boolean"
          },
          "gift_options": {
            "$ref": "#/components/schemas/gift_option_view"
          },
          "id": {
            "type": "string"
          },
          "package_dimension": {
            "properties": {
              "depth": {
                "format": "int64",
                "type": "number"
              },
              "height": {
                "format": "int64",
                "type": "number"
              },
              "unit": {
                "type": "string"
              },
              "width": {
                "format": "int64",
                "type": "number"
              }
            },
            "type": "object"
          },
          "package_type": {
            "type": "string"
          },
          "package_weight": {
            "$ref": "#/components/schemas/i_weight"
          },
          "reference": {
            "type": "string"
          },
          "service": {
            "type": "string"
          },
          "shipping_address": {
            "$ref": "#/components/schemas/address_view"
          },
          "shipping_method": {
            "type": "string"
          },
          "signature": {
            "type": "string"
          },
          "tax_amount": {
            "$ref": "#/components/schemas/amount_view"
          },
          "total_weight": {
            "$ref": "#/components/schemas/i_weight"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "i_description_part": {
        "properties": {
          "content": {
            "type": "string"
          },
          "is_html": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "i_description_tooltip": {
        "properties": {
          "html_content": {
            "type": "string"
          },
          "target": {
            "format": "int64",
            "type": "number"
          }
        },
        "type": "object"
      },
      "i_order_dynamic_content": {
        "properties": {
          "custom_fields": {
            "items": {
              "$ref": "#/components/schemas/i_custom_field_view"
            },
            "type": "array"
          },
          "eligible_payment_methods": {
            "items": {
              "$ref": "#/components/schemas/eligible_payment_method"
            },
            "type": "array"
          },
          "gift_option_view": {
            "$ref": "#/components/schemas/i_gift_option_view"
          },
          "hide_apm": {
            "items": {
              "enum": [
                "PAYPAL",
                "AFFIRM",
                "AFTERPAY",
                "AMAZONPAY",
                "KLARNA",
                "RADIALPAYPAL",
                "SEZZLE",
                "RADIALKLARNA",
                "CREDOVA",
                "GOOGLEPAY"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "order_notice": {
            "type": "string"
          },
          "payment_notice": {
            "type": "string"
          },
          "shipping_info_notice": {
            "type": "string"
          },
          "shipping_notice": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "i_custom_field_view": {
        "properties": {
          "checkout_step": {
            "enum": [
              "SHIPPING_STEP",
              "DELIVERY_STEP",
              "PAYMENT_STEP",
              "ACCOUNT_REGISTRATION_SSO"
            ],
            "type": "string"
          },
          "dynamic": {
            "type": "boolean"
          },
          "context": {
            "enum": [
              "CHECKOUT",
              "SSO"
            ],
            "type": "string"
          },
          "external_id": {
            "type": "string"
          },
          "field_setup": {
            "type": "string"
          },
          "helper_text": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "position": {
            "format": "int64",
            "type": "number"
          },
          "public_id": {
            "type": "string"
          },
          "required": {
            "type": "boolean"
          },
          "subscribeToNewsletter": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "eligible_payment_method": {
        "properties": {
          "eligible": {
            "type": "boolean"
          },
          "transaction_processor_type": {
            "$ref": "#/components/schemas/payment_service"
          }
        },
        "type": "object"
      },
      "payment_service": {
        "enum": [
          "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"
        ],
        "type": "string"
      },
      "i_gift_option_view": {
        "properties": {
          "hide_gift_message": {
            "type": "boolean"
          },
          "hide_gift_wrap": {
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "i_order_external_data": {
        "properties": {
          "steam_id": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "errors_bolt_api_response": {
        "properties": {
          "errors": {
            "$ref": "#/components/schemas/errors_bolt_api"
          },
          "result": {
            "$ref": "#/components/schemas/request_result"
          }
        },
        "type": "object"
      },
      "errors_bolt_api": {
        "items": {
          "$ref": "#/components/schemas/error_bolt_api"
        },
        "type": "array"
      },
      "error_bolt_api": {
        "properties": {
          "code": {
            "$ref": "#/components/schemas/code"
          },
          "message": {
            "$ref": "#/components/schemas/message"
          }
        },
        "type": "object",
        "description": "Error object containing custom error information"
      },
      "code": {
        "description": "Custom-defined Bolt error code. This can be used to programmatically react to specific errors.",
        "format": "int64",
        "type": "integer",
        "examples": [
          2001005
        ]
      },
      "message": {
        "description": "Human-readable description of the error for developers. Should not be shown to users and is not localized.",
        "type": "string",
        "examples": [
          "The input is missing a required parameter."
        ]
      },
      "request_result": {
        "description": "Custom-defined Bolt result object.",
        "properties": {
          "success": {
            "$ref": "#/components/schemas/request_failed"
          }
        },
        "type": "object"
      },
      "request_failed": {
        "type": "boolean",
        "description": "Indicates that the request failed. This value is always false.",
        "examples": [
          false
        ]
      }
    },
    "responses": {
      "order_generate_error_400": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/errors_bolt_api_response"
            }
          }
        },
        "description": "Generic Error Schema"
      },
      "order_generate_error_403": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/errors_bolt_api_response"
            }
          }
        },
        "description": "Generic Error Schema"
      },
      "order_generate_error_422": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/errors_bolt_api_response"
            }
          }
        },
        "description": "Generic Error Schema"
      }
    },
    "securitySchemes": {
      "OAuth": {
        "description": "Bolt utilizes the OAuth flow that developers can use to attain access to Bolt Account data via APIs.\nFor all APIs that require authorization, please provide your `access_token` returned from `/v1/oauth/token` via the basic auth bearer header `Authorization: bearer ${TOKEN}`.\n[Read more about the OAuth token endpoint.](/api-bolt/#tag/OAuth)\n",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://api.boltapp.com/v1/oauth/authorize",
            "refreshUrl": "https://api.boltapp.com/v1/oauth/token",
            "scopes": {
              "bolt.account.manage": "This scope grants permissions to perform read/edit/delete actions on Bolt Account data",
              "bolt.account.view": "This scope grants permissions to perform read only actions on Bolt Account data",
              "openid": "This scope grants permissions that enable Bolt SSO by granting an id token JWT that stores account data. Not used in v1/account endpoints"
            },
            "tokenUrl": "https://api.boltapp.com/v1/oauth/token"
          }
        },
        "type": "oauth2"
      },
      "X-API-Key": {
        "description": "Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard.",
        "in": "header",
        "name": "X-API-Key",
        "type": "apiKey"
      }
    }
  }
}
```