Checkouts
For more information on authenticating BigCommerce APIs, see Authentication.
Create and manage checkouts from existing carts using BigCommerce checkout logic.
Get a Checkout
GET /stores/{store_hash}/v3/checkouts/{checkoutId}
Request
Returns a Checkout.
Notes
The cart ID and checkout ID are the same.
Authentication
- X-Auth-Token in header - required
Parameters
- store_hash in path - string
- checkoutId in path - string - required
ID of the checkout; the same as the cart ID.
- Accept in header with default of application/json - string - required
The MIME type of the response body.
- include in query - string
cart.line_items.physical_items.options- physical optionscart.line_items.digital_items.options- digital optionsconsignments.available_shipping_options- shipping optionspromotions.banners- promotion options
example
curl --request GET \ --url 'https://api.bigcommerce.com/stores/[store_hash]/v3/checkouts/[checkoutId]' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'X-Auth-Token: xxxxxxxxxxxxxxxxx'
Response
Body
object | application/json
dataobject
metaobject
Response metadata.
Update Customer Messages
PUT /stores/{store_hash}/v3/checkouts/{checkoutId}
Request
Change customer message pertaining to an existing Checkout.
Limits:
- 2000 characters for customer message
Authentication
- X-Auth-Token in header - required
Parameters
- store_hash in path - string
- Content-Type in header with default of application/json - string - required
The MIME type of the request body.
customer_message is required (maximum length is 2000).
Body
object | application/json
customer_messagestring
required
example
{ "customer_message": "string" }
Response
Body
object | application/json
dataobject
metaobject
Response metadata.
example
{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "cart": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "customer_id": 1, "email": "user@example.com", "currency": { "code": "USD" }, "base_amount": 5, "channel_id": 0, "discount_amount": 0.5, "cart_amount_inc_tax": 4.14, "cart_amount_ex_tax": 3.6, "coupons": [ { "code": "SHOPNOW", "id": 1, "coupon_type": "percentage_discount", "discounted_amount": 0.9 } ], "discounts": [ { "id": "5eba1f1e-0ec5-40f7-8058-f7b452c7237d", "discounted_amount": 1.4 } ], "line_items": { "physical_items": [ { "quantity": 0, "id": "string", "variant_id": 0, "product_id": 0, "sku": "string", "name": "string", "url": "string", "is_taxable": true, "image_url": "string", "discounts": [ { "id": 0, "discounted_amount": 0 } ], "discount_amount": 0, "coupon_amount": 0, "original_price": 0, "list_price": 0, "sale_price": 0, "extended_list_price": 0, "extended_sale_price": 0, "is_require_shipping": true, "is_mutable": true, "parent_id": 0, "gift_wrapping": { "name": "string", "message": "string", "amount": 0, "amount_as_integer": 0 } } ], "digital_items": [ { "quantity": 0, "id": "string", "variant_id": 0, "parent_id": 0, "product_id": 0, "sku": "string", "name": "string", "url": "string", "is_mutable": true, "is_require_shipping": true, "is_taxable": true, "image_url": "string", "discounts": [ { "id": "string", "discounted_amount": 0 } ], "discount_amount": 0, "coupon_amount": 0, "original_price": 0, "list_price": 0, "sale_price": 0, "extended_list_price": 0, "extended_sale_price": 0 } ], "gift_certificates": [ { "theme": "string", "amount": 0, "sender": { "name": "string", "email": "string" }, "recipient": { "name": "string", "email": "string" }, "id": "string", "name": "string", "taxable": true, "message": "string" } ], "custom_items": [ { "quantity": 0, "id": "string", "extended_list_price": 0, "list_price": 0, "sku": "string", "name": "string", "image_url": "string" } ] }, "created_time": "string", "updated_time": "string" }, "billing_address": { "first_name": "string", "last_name": "string", "email": "string", "company": "string", "address1": "string", "address2": "string", "city": "string", "state_or_province": "string", "state_or_province_code": "string", "country_code": "string", "postal_code": "string", "phone": "string", "custom_fields": [ { "field_id": "string", "field_value": "string" } ], "id": "string" }, "consignments": [ { "id": "string", "shippingAddress": {}, "address": { "first_name": "string", "last_name": "string", "email": "string", "company": "string", "address1": "string", "address2": "string", "city": "string", "state_or_province": "string", "state_or_province_code": "string", "country_code": "string", "postal_code": "string", "phone": "string", "custom_fields": [ { "field_id": "string", "field_value": "string" } ], "id": "string" }, "available_shipping_options": [ { "description": "string", "id": "string", "type": "string", "image_url": "string", "cost": 0, "transit_time": "string" } ], "selected_shipping_option": { "description": "string", "id": "string", "type": "string", "image_url": "string", "cost": 0, "transit_time": "string" }, "coupon_discounts": [ { "code": "string", "amount": 0 } ], "discounts": [ { "id": 0 } ], "shipping_cost_inc_tax": 0, "shipping_cost_ex_tax": 0, "handling_cost_inc_tax": 0, "handling_cost_ex_tax": 0, "line_item_ids": [ "string" ], "selected_pickup_option": { "pickup_method_id": 0 } } ], "taxes": [ { "name": "string", "amount": 0 } ], "coupons": [ { "code": "SHOPNOW", "id": 1, "coupon_type": "percentage_discount", "discounted_amount": 0.9 } ], "order_id": "string", "shipping_cost_total_inc_tax": 0, "shipping_cost_total_ex_tax": 0, "handling_cost_total_inc_tax": 0, "handling_cost_total_ex_tax": 0, "tax_total": 0, "subtotal_inc_tax": 0, "subtotal_ex_tax": 0, "grand_total": 0, "created_time": "string", "updated_time": "string", "customer_message": "string", "promotions": [ { "banners": [ { "id": "string", "type": "string", "page": [ "string" ], "text": "string" } ] } ] }, "meta": {} }