--- title: "Authorize a Card" method: POST path: "/v1/merchant/transactions/authorize" tags: ["Transactions"] --- # Authorize a Card `POST /v1/merchant/transactions/authorize` This endpoint authorizes card payments and has three main use cases: * • Authorize a payment using an unsaved payment method for a guest or logged-in shopper. * • Authorize a payment using a saved payment method for a logged-in shopper. * • Re-charge a previous transaction using the `credit_card_id` of the transaction. ## Headers - `X-Publishable-Key` string - `Idempotency-Key` string ## Request body - union - MerchantCreditCardAuthorization — This request is used for authorizing a new, unsaved card. - `auto_capture` boolean — This property determines how the transaction is processed after authorization. If set to `true`, the transaction is placed in a queue for automatic capture. This process is asynchronous, meaning the transaction may not immediately appear as captured after the authorization request. This is because the transaction is in a transitional state as it moves from authorization to capture. If `auto_capture` is set to `false`, the transaction is only authorized and must be manually captured. - `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. - … - `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. - … - `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. - `create_bolt_account` boolean, required — If `true`, the guest shopper is provided a Bolt Account using their email address as its unique ID; if `false`, no information is saved at checkout. - `credit_card` CreditCard, required — The credit_card object is used to to pay for guest-checkout transactions or save payment method details to an account. Once saved, you can reference the credit card with the associated `credit_card_id` for future transactions. Add `billing_address` to this if storing a billing address for a returning shopper. - `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. - `bin` string, required — The Bank Identification Number for the credit card; this is typically the first 4-6 digits of the credit card number. - `expiration` string, required — The expiration date of the credit card. - `last4` string, required — The last 4 digits of the credit card number. - `postal_code` string, required — Used for the postal or zip code associated with the credit card. - `priority` 1 | 2 — Used to indicate the card's priority. '1' indicates primary, while '2' indicates a secondary card. - `save` boolean — Determines whether or not the credit card will be saved to the shopper's account. Defaults to `true`. - `token` string, required — The Bolt token associated to the credit card. - `token_type` 'bolt', required — Used to define which payment processor generated the token for this credit card; for those using Bolt's tokenizer, the value must be `bolt`. - `affirm_vcn_token` string, nullable — The checkout token associated with Affirm VCN credit cards. - `division_id` string, required — The unique ID associated to the merchant's Bolt Account division; Merchants can have different divisions to suit multiple use cases (storefronts, pay-by-link, phone order processing). Use the Bolt Merchant Dashboard to switch between divisions and find the division ID under `Merchant Division Public ID`. - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `previous_transaction_id` string, nullable — The unique ID associated with to the shopper's previous subscription-based transaction. Leave `null` for standard, non-subscription transactions. - `processing_initiator` 'initial_card_on_file' | 'initial_recurring' | 'stored_cardholder_initiated' | 'stored_merchant_initiated' | 'following_recurring' | 'cardholder_initiated' | 'recurring' — Determines who initiated the transaction (e.g. shopper, merchant) and how they did it (e.g. recurring subscription, on-file card). * `initial_card_on_file` - The first transaction made for a card. The system then saves this card for future transactions. * `initial_recurring` - The first time any card is used to pay for a recurring charge. For example, a subscription. * `stored_cardholder_initiated` - The subsequent (second, third, etc.) transactions a shopper initiates with a stored card. This includes every situation during which a cardholder requests a charge, for example if the cardholder requests a merchant charge their card. * `stored_merchant_initiated` - The subsequent (second, third, etc.) transactions a merchant initiates with a stored card only when the cardholder does not request the charge. For example, when a customer service representative buys on behalf of a shopper or when a business adds funds to a public transit card. * `following_recurring` - The subsequent (second, third, etc.) transactions a card is used to pay for a recurring charge. For example, a subscription. * `cardholder_initiated` - When a cardholder begins a transaction that isn’t stored in Bolt and won’t be stored in Bolt for future transactions. * `recurring` - Any time a card is used to pay for a recurring charge (for example, a subscription). Only use this value when you don’t know if it’s the first recurring charge. - `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. - `source` 'direct_payments', required - `user_identifier` UserIdentifier, required — The object containing key lookup IDs associated with the shopper's account, such as the unique email address and phone number. - `artifact` string - `email` string, email — An email address. - `email_id` string — The ID associated with the identifying email address for this account. - `phone` string, required — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign. - `phone_id` string — The ID associated with the identifying phone number for this account. - `user_identity` UserIdentity, required - `first_name` string — The person's first name. - `last_name` string — The person's last name. - MerchantCreditCardAuthorizationRecharge — This request is used for authorizing an existing, saved card associated with the account. - `auto_capture` boolean — This property determines how the transaction is processed after authorization. If set to `true`, the transaction is placed in a queue for automatic capture. This process is asynchronous, meaning the transaction may not immediately appear as captured after the authorization request. This is because the transaction is in a transitional state as it moves from authorization to capture. If `auto_capture` is set to `false`, the transaction is only authorized and must be manually captured. - `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. - … - `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. - … - `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. - `credit_card_id` string, required — The unique ID associated to the saved credit card in the account's wallet. - `division_id` string, required — The unique ID associated to the merchant's Bolt Account division; Merchants can have different divisions to suit multiple use cases (storefronts, pay-by-link, phone order processing). Use the Bolt Merchant Dashboard to switch between divisions and find the division ID under `Merchant Division Public ID`. - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `previous_transaction_id` string, nullable — The unique ID associated with to the shopper's previous subscription-based transaction. Leave `null` for standard, non-subscription transactions. - `processing_initiator` 'initial_card_on_file' | 'initial_recurring' | 'stored_cardholder_initiated' | 'stored_merchant_initiated' | 'following_recurring' | 'cardholder_initiated' | 'recurring' — Defines which payment method was used to initiate the transaction. - `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. - `source` 'direct_payments', required - `user_identifier` UserIdentifier, required — The object containing key lookup IDs associated with the shopper's account, such as the unique email address and phone number. - `artifact` string - `email` string, email — An email address. - `email_id` string — The ID associated with the identifying email address for this account. - `phone` string, required — A phone number following E164 standards, in its globalized format, i.e. prepended with a plus sign. - `phone_id` string — The ID associated with the identifying phone number for this account. - `user_identity` UserIdentity, required - `first_name` string — The person's first name. - `last_name` string — The person's last name. ## Response `200` Authorization Successful - IAuthorizeResultView - `did_create_bolt_account` boolean - `order_number` string - `transaction` TransactionView - `amount` AmountView - `amount` number - `currency` string - `currency_symbol` string - `authorization` CreditCardAuthorizationView - `auth` string - `avs_response` '00' | '01' | '02' | '10' | '11' | '12' | '13' | '14' | '20' | '30' | '31' | '32' | '33' | '34' | '40' | 'adyen_' | 'adyen_A' | 'adyen_N' | 'adyen_U' | 'adyen_S' | 'adyen_R' | 'adyen_W' | 'adyen_T' | 'adyen_Z' | 'adyen_D' | 'adyen_F' | 'adyen_M' | 'adyen_X' | 'adyen_Y' | 'adyen_B' | 'adyen_P' | 'adyen_C' | 'adyen_G' | 'adyen_I' | 'adyen_K' - `cvv_response` 'M' | 'N' | 'P' | 'S' | 'U' | 'D' | 'X' | 'Y' | '1' | '2' | '3' | 'pass' | 'fail' | 'unavailable' | 'unchecked' | 'braintree_M' | 'braintree_N' | 'braintree_U' | 'braintree_B' | 'braintree_A' | 'braintree_I' | 'braintree_S' | 'CVV2' - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `metadata` object - `processor` 'vantiv' | 'adyen_payfac' | 'adyen_gateway' | 'stripe' | 'braintree' | 'cybersource' | 'nmi' | 'authorize_net' | 'radial' | 'shopify_payments' | 'rocketgate' - `reason` 'none' | 'invalid_amount' | 'invalid_cvv' | 'invalid_cc_number' | 'expired' | 'risk' | 'lost_stolen' | 'call_issuer' | 'invalid_merchant_for_card' | 'unsupported_payment_method' | 'processor_server_error' — The reason code explaining the authorization status. * `1` - none * `2` - invalid_amount * `3` - invalid_cvv * `4` - invalid_cc_number * `5` - expired * `6` - risk * `7` - lost_stolen * `8` - call_issuer * `9` - invalid_merchant_for_card * `10` - unsupported_payment_method - `status` 'succeeded' | 'declined' | 'error' — The status of the authorization request. * `1` - succeeded * `2` - declined * `3` - error - `capture` CaptureView — Deprecated. Use `captures`. - `amount` AmountView - `amount` number - `currency` string - `currency_symbol` string - `id` string — The unique ID for the capture. **Nullable** for Transactions Details. - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `metadata` object — Additional information about the capture. For example, the processor capture ID. **Nullable** for Transactions Details. - `splits` object[] — A split of fees by type and amount. **Nullable** for Transactions Details. - `amount` AmountView - `amount` number - `currency` string - `currency_symbol` string - `type` 'net' | 'processing_fee' | 'risk_fee' | 'apm_fee' | 'network_fee' | 'platform_fee' | 'bolt_account_fee' — Fee type options. **Nullable** for Transactions Details. - `status` 'succeeded' | 'declined' | 'error' — The status of the capture. **Nullable** for Transactions Details. - `captures` CreditCardCaptureView[] - `amount` AmountView - `amount` number - `currency` string - `currency_symbol` string - `id` string — The unique ID for the capture. **Nullable** for Transactions Details. - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `metadata` object - `splits` TransactionSplitsView - `amount` AmountView - `amount` number - `currency` string - `currency_symbol` string - `type` 'net' | 'processing_fee' | 'float' | 'reserve' | 'adjustment' | 'bolt_fee' - `status` 'succeeded' | 'declined' | 'error' — The status of the capture. **Nullable** for Transactions Details. - `credit` CreditCardCreditView - `status` 'succeeded' | 'declined' | 'error' | 'pending' | 'in progress' — The status of the refund to a card. - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `date` integer — Transaction date. **Nullable** for Transactions Details. - `from_consumer` ConsumerSelfView - `first_name` string — The given name of the person associated with this record. - `id` string - `last_name` string — The surname of the person associated with this record. - `authentication` LoginView - `actions` string[] - `methods` string[] - `sso_authorization_url` string - `email_verified` boolean - `emails` EmailView[] - `address` string - `id` string - `priority` 'primary' | 'listed' — Describes the card's priority. - `status` string - `phones` PhoneView[] - `country_code` string — Used for the 2-digit ISO 3166-1 alpha 2 country code associated with this address. - `id` string - `number` string - `priority` 'primary' | 'listed' - `status` string - `platform_account_status` 'none' | 'linked' | 'unlinked' - `from_credit_card` CreditCardView — Contains details about the credit card transaction. - `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. - `bin` string — The Bank Identification Number for the credit card; this is typically the first 4-6 digits of the credit card number. **Nullable** for Transactions Details. - `display_network` 'Credit Card' | 'American Express' | 'Diners Club' | 'Discover' | 'JCB' | 'MasterCard' | 'Union Pay' | 'Visa' — The card's network. **Nullable** for Transactions Details. - `expiration` integer — The card's expiration. **Nullable** for Transactions Details. - `icon_asset_path` string — The asset link for displayed icons. This link varies depending on payment method used. **Nullable** for Transactions Details. - `id` string — The card's ID. **Nullable** for Transactions Details. - `last4` string — The card's last 4 digits. **Nullable** for Transactions Details. - `network` 'visa' | 'mastercard' | 'amex' | 'discover' | 'dinersclub' | 'jcb' | 'unionpay' | 'alliancedata' | 'citiplcc' | 'unknown' — The card's network code. **Nullable** for Transactions Details. Note: LEGACY diners_club_us_ca now tagged as mastercard - `priority` 'primary' | 'listed' — Describes the card's priority. - `status` 'active' | 'created' | 'inactive' | 'transient' — The card's status. **Nullable** for Transactions Details. - `token` string — The Bolt token associated to the credit card. Required for new, unsaved cards. - `token_type` 'vantiv' | 'applepay' | 'bolt' | 'stripe' | 'plcc' | 'applepay_encrypted_blob' — Used to define which payment processor generated the token for this credit card. - `id` string — The unique ID associated with the transaction. **Nullable** for Transactions Details. - `indemnification_decision` 'unknown' | 'indemnified' | 'not_indemnified' — Describes whether the transaction is indemnified by Bolt for fraud. - `indemnification_reason` 'unknown' | 'checkout' | 'virtual_terminal' | 'merchant_back_office' | 'merchant_force_approved' | 'reversibly_rejected' | 'irreversibly_rejected' | 'risk_engine_approved' | 'analyst_approved' | 'auth_verification' | 'paypal' | 'afterpay' | 'direct_payments' | 'whitelist' | 'external_review' | 'affirm' | 'merchant_ip_address' | 'amazon_pay' | 'apple_pay' | 'phone_order' | 'klarna' | 'cardholder_authentication' | 'address_change_rejected' | 'indemnify_direct_payments' | 'indemnify_virtual_terminal' | 'membership_subscription' | 'embedded_guest_checkout' | 'risk_assessment_only' | 'sezzle' | 'credova' | 'subscription' | 'indemnify_apm_transaction' — Describes the reason that the transaction is or is not indemnified by Bolt for fraud. - `last4` string — The card's last 4 digits. **Nullable** for Transactions Details. - `last_viewed_utc` number - `merchant_division` MerchantDivisionSummaryView - `account_page_url` string - `api_base_domain_url` string - `base_domain_url` string - `confirmation_redirect_url` string - `create_order_url` string - `debug_url` string - `description` string - `display_name` string - `get_account_url` string - `shopper_custom_fields_updated_url` string - `hook_type` '1' | '2' | '3' | '4' | '5' | '6' - `hook_url` string - `id` string - `is_universal_merchant_api` boolean - `is_webhooks_v2` boolean - `logo` MerchantDivisionLogoView - `domain` string - `resource` string - `logo_dashboard` MerchantDivisionLogoView - `domain` string - `resource` string - `merchant_id` string - `mobile_app_domain_url` string - `oauth_logout_url` string - `oauth_redirect_url` string - `platform` string - `plugin_config_url` string - `privacy_policy_url` string - `product_info_url` string - `public_id` string - `remote_apiurl` string - `shipping_and_tax_url` string - `shipping_url` string - `status` string - `tax_url` string - `terms_of_service_url` string - `universal_merchant_api_url` string - `update_cart_url` string - `use_async_refunds_amazon_pay` boolean - `use_async_refunds_paypal` boolean - `validate_additional_account_data_url` string - `merchant_password_login_url` string — (Optional) Link shoppers can use to log into a merchant store via the Bolt SSO modal. - `merchant_order_number` string - `order_decision` OrderDecisionDetailsView - `decision_factors` string[] - `score` number - `processor` 'adyen_gateway' | 'adyen_payfac' | 'affirm' | 'afterpay' | 'alliance_data' | 'amazon_pay' | 'authorize_net' | 'braintree' | 'checkout_com' | 'cybersource' | 'first_data' | 'klarna' | 'nmi' | 'orbital' | 'paypal' | 'radial' | 'radial_klarna' | 'radial_paypal' | 'rocketgate' | 'sezzle' | 'shopify_payments' | 'stripe' | 'vantiv' — The processor used. **Nullable** for Transactions Details. - `reference` string — The transaction's 12-digit Bolt reference ID. **Nullable** for Transactions Details. - `review_ticket` ReviewTicketView - `id` string - `request_deadline` number - `status` string - `risk_insights` RiskModelExternalResultView - `available` boolean - `decision_factors` string[] — Used to list a total of up to 5 decision factors used by the risk model to determine the risk analysis result. - `fraud_probability` number - `payment_instrument_factors` object - `risk_review_status` 'unknown' | 'needs_review' | 'reviewed' — Describes the current Risk Review status. A transaction could be unreviewed, reviewed, or pending manual review by the Bolt team. - `risk_score` integer - `splits` TransactionSplitsView[] - `amount` AmountView - `amount` number - `currency` string - `currency_symbol` string - `type` 'net' | 'processing_fee' | 'float' | 'reserve' | 'adjustment' | 'bolt_fee' - `status` 'in_progress' | 'completed' | 'cancelled' | 'failed' | 'pending' | 'created' | 'authorized' | 'rejected_reversible' | 'rejected_irreversible' — The transaction's status. - `to_consumer` ConsumerSelfView - `first_name` string — The given name of the person associated with this record. - `id` string - `last_name` string — The surname of the person associated with this record. - `authentication` LoginView - `actions` string[] - `methods` string[] - `sso_authorization_url` string - `email_verified` boolean - `emails` EmailView[] - `address` string - `id` string - `priority` 'primary' | 'listed' — Describes the card's priority. - `status` string - `phones` PhoneView[] - `country_code` string — Used for the 2-digit ISO 3166-1 alpha 2 country code associated with this address. - `id` string - `number` string - `priority` 'primary' | 'listed' - `status` string - `platform_account_status` 'none' | 'linked' | 'unlinked' - `to_credit_card` CreditCardView — Contains details about the credit card transaction. - `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. - `bin` string — The Bank Identification Number for the credit card; this is typically the first 4-6 digits of the credit card number. **Nullable** for Transactions Details. - `display_network` 'Credit Card' | 'American Express' | 'Diners Club' | 'Discover' | 'JCB' | 'MasterCard' | 'Union Pay' | 'Visa' — The card's network. **Nullable** for Transactions Details. - `expiration` integer — The card's expiration. **Nullable** for Transactions Details. - `icon_asset_path` string — The asset link for displayed icons. This link varies depending on payment method used. **Nullable** for Transactions Details. - `id` string — The card's ID. **Nullable** for Transactions Details. - `last4` string — The card's last 4 digits. **Nullable** for Transactions Details. - `network` 'visa' | 'mastercard' | 'amex' | 'discover' | 'dinersclub' | 'jcb' | 'unionpay' | 'alliancedata' | 'citiplcc' | 'unknown' — The card's network code. **Nullable** for Transactions Details. Note: LEGACY diners_club_us_ca now tagged as mastercard - `priority` 'primary' | 'listed' — Describes the card's priority. - `status` 'active' | 'created' | 'inactive' | 'transient' — The card's status. **Nullable** for Transactions Details. - `token` string — The Bolt token associated to the credit card. Required for new, unsaved cards. - `token_type` 'vantiv' | 'applepay' | 'bolt' | 'stripe' | 'plcc' | 'applepay_encrypted_blob' — Used to define which payment processor generated the token for this credit card. - `transaction_properties` object - `type` 'cc_payment' | 'cc_credit' | 'funding_transfer' | 'processing_fee_transfer' | 'reserve_transfer' | 'float_transfer' | 'merchant_credit' | 'merchant_debit' | 'funding_withdrawal' | 'processing_fee_withdrawal' | 'zero_amount' | 'bolt_fee_transfer' | 'bolt_fee_withdrawal' | 'bank_account_verification' | 'authorization_verification' | 'paypal_payment' | 'paypal_refund' | 'apm_payment' | 'apm_refund' | 'zero_amount_verification' — The type of transaction. - `void` CreditCardVoidView - `cause` string — Specifies why this particular transaction is voided. - `merchant_event_id` string — The reference ID associated with a transaction event (auth, capture, refund, void). This is an arbitrary identifier created by the merchant. Bolt does not enforce any uniqueness constraints on this ID. It is up to the merchant to generate identifiers that properly fulfill its needs. - `status` 'succeeded' | 'declined' | 'error' — The status of the void request. - `void` string — The void ID returned from the payment processor. - `view_status` 'not_viewed' | 'viewed' | 'viewing' --- [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)