Carts
Completes cart checkout
Submits the cart for payment and converts it to an order.
Send expected_total and expected_currency, the total the shopper
was shown, and the charge boundary refuses (409,
cart_total_changed) to charge anything else. Without them the cart
is charged whatever it says when the request is processed.
POST
/
api
/
public
/
v2025-06
/
commerce
/
carts
/
{cart_token}
/
checkout
Completes cart checkout
curl --request POST \
--url https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expected_total": "126.53",
"expected_currency": "USD"
}
'import requests
url = "https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout"
payload = {
"expected_total": "126.53",
"expected_currency": "USD"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({expected_total: '126.53', expected_currency: 'USD'})
};
fetch('https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'expected_total' => '126.53',
'expected_currency' => 'USD'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout"
payload := strings.NewReader("{\n \"expected_total\": \"126.53\",\n \"expected_currency\": \"USD\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expected_total\": \"126.53\",\n \"expected_currency\": \"USD\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expected_total\": \"126.53\",\n \"expected_currency\": \"USD\"\n}"
response = http.request(request)
puts response.read_body{
"order": {
"id": 58830,
"first_name": "Holly",
"last_name": "Flax",
"email": "holly.flax@dundermifflin.com",
"phone": "+15705550142",
"order_number": "DM-100482",
"token": "fo_3VbQ8mTk2WzR7nHp5LxYc9",
"status": "awaiting_shipment",
"order_status": "pending",
"financial_status": "paid",
"fulfillment_status": "unfulfilled",
"warehouse_id": null,
"order_type": "purchased",
"amount": "126.53",
"amount_in_base": "126.53",
"base_to_currency_rate": "1.0",
"refundable_amount": "126.53",
"note": null,
"recurring": [],
"order_confirmation_url": "https://checkout.fluid.app/orders/fo_3VbQ8mTk2WzR7nHp5LxYc9",
"currency_code": "USD",
"created_at": "2026-09-17T14:25:41Z",
"updated_at": "2026-09-17T14:25:43Z",
"metadata": {},
"external_id": null,
"enrollment_pack": null,
"enrollment_member_type": null,
"resulting_member_type": null,
"source": "web",
"points_applied": 0,
"free_shipping": false,
"discount_codes": [],
"created_subscriptions": []
},
"meta": {
"request_id": "c41e7a90-3b5d-4f28-9e61-8d2a0b7f5c13",
"shop_url": "https://shop.dundermifflin.com",
"timestamp": "2026-09-17T14:25:43Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {
"enrollment": true,
"id": 123,
"cart_token": "<string>",
"state": "<string>",
"state_revision": 1,
"population_status": "pending",
"email": "<string>",
"phone": "<string>",
"phone_dialable": true,
"sms_marketing_preselected": true,
"language_iso": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"currency_decimal_places": 123,
"type": "<string>",
"buyer_rep_id": 123,
"customer_id": 123,
"enrollment_pack_id": 123,
"enrollment_member_type": {
"id": "22c58158-7f6c-4f33-a033-32e259941684",
"slug": "rep",
"name": "Representative"
},
"email_marketing": true,
"sms_marketing": true,
"auto_apply_points": true,
"processed": true,
"payment_in_progress": true,
"payment_resume_url": "<string>",
"valid_for_checkout": true,
"valid_for_checkout_pre_payment": true,
"checkout_blockers": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"payment": "not_attempted"
}
],
"contains_subscription": true,
"vault_without_charge": true,
"payment_method_auto_assignable": true,
"requires_payment_method": true,
"requires_3ds": true,
"immutable_items": true,
"digital_only": true,
"points_enabled": true,
"messages": {},
"metadata": {},
"cv_total": "<string>",
"qv_total": "<string>",
"amount_total": 123,
"amount_total_in_currency": "<string>",
"sub_total": 123,
"sub_total_in_currency": "<string>",
"tax_total": 123,
"tax_exempt": true,
"tax_total_in_currency": "<string>",
"tax_total_for_display": "<string>",
"inclusive_shipping_tax": 123,
"shipping_total": 123,
"shipping_total_in_currency": "<string>",
"shipping_total_for_display": "<string>",
"discount_total": 123,
"discount_total_in_currency": "<string>",
"subtotal_after_discounts": 123,
"subtotal_after_discounts_in_currency": "<string>",
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"totals": {
"gross_subtotal": "<string>",
"gross_subtotal_in_currency": "<string>",
"net_subtotal": "<string>",
"net_subtotal_in_currency": "<string>",
"item_tax": "<string>",
"item_tax_in_currency": "<string>",
"shipping_net": "<string>",
"shipping_net_in_currency": "<string>",
"shipping_tax": "<string>",
"shipping_tax_in_currency": "<string>",
"total_tax": "<string>",
"total_tax_in_currency": "<string>",
"price_inclusive_of_tax": true,
"tax_label": "<string>"
},
"enrollment_fee": 123,
"enrollment_fee_in_currency": "<string>",
"transaction_fee": 123,
"transaction_fee_in_currency": "<string>",
"shipping_discount": 123,
"discount_codes": [
"<string>"
],
"product_discount_codes": [
"<string>"
],
"shipping_discount_codes": [
"<string>"
],
"customer_total_points": 123,
"customer_total_points_decimal": "120.0000",
"customer_total_points_in_currency": "<string>",
"points_applied": 123,
"points_applied_decimal": "120.0000",
"points_applied_amount_in_currency": "<string>",
"remaining_customer_points": 123,
"remaining_customer_points_decimal": "120.0000",
"remaining_customer_points_amount_in_currency": "<string>",
"remaining_cart_amount_after_points": 123,
"remaining_cart_amount_after_points_in_currency": "<string>",
"max_applicable_points": 123,
"points_unavailable_in_market": true,
"max_applicable_points_decimal": "120.0000",
"total_creditable_points": 123,
"total_creditable_points_decimal": "120.0000",
"shipping_address": {},
"billing_address": {},
"discount_breakdown": {
"internal_discounts": 123,
"external_discounts": 123,
"total_discounts": 123
},
"external_discount": {},
"buyer_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>",
"external_id": "<string>"
},
"buyer_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volume_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>"
},
"volume_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"available_shipping_methods": [
{
"id": "<string>",
"title": "<string>",
"price": 123,
"delivery_time_estimate": "<string>",
"price_label": "<string>"
}
],
"available_payment_methods": [
{}
],
"payment_unavailable_reason": "no_gateway_for_country",
"payment_account": {},
"shipping_method": {
"id": "<string>",
"name": "<string>"
},
"payment_method": {},
"items": [
{
"id": 123,
"title": "<string>",
"quantity": 123,
"price": "<string>",
"price_in_currency": "<string>",
"discount_amount": "<string>",
"discount_amount_in_currency": "<string>",
"tax": "<string>",
"tax_in_currency": "<string>",
"cv": "<string>",
"qv": "<string>",
"cv_total": "<string>",
"qv_total": "<string>",
"total": "<string>",
"total_in_currency": "<string>",
"line_total_in_currency": "<string>",
"total_after_discounts": "<string>",
"total_after_discounts_in_currency": "<string>",
"line_total_after_discounts_in_currency": "<string>",
"regular_line_total_in_currency": "<string>",
"unit_price_display_authoritative": true,
"price_unavailable": true,
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
},
"enrollment_pack_id": 123,
"subscription": true,
"subscription_plan_id": 123,
"subscription_plans": [
{}
],
"subscription_only": true,
"subscription_interval": 123,
"subscription_interval_unit": "<string>",
"subscription_interval_unit_identifier": "<string>",
"subscription_price": "<string>",
"subscription_price_in_currency": "<string>",
"subscription_start": "<string>",
"subscribe_and_save": "<string>",
"subscribe_and_save_in_currency": "<string>",
"subscribe_and_save_for_display": "<string>",
"display_to_customer": true,
"metadata": {},
"image_url": "<string>",
"free_item": true,
"allow_subscription": true,
"enrollment": true,
"errors": [
"<string>"
],
"creditable_points": 123,
"product": {},
"variant": {
"id": 123,
"title": "<string>",
"display_name": "<string>",
"image_url": "<string>",
"image_path": "<string>",
"sku": "<string>",
"primary_image": "<string>",
"price": 123,
"price_in_currency": "<string>",
"currency_code": "<string>",
"options": [
{
"title": "<string>",
"value": "<string>"
}
],
"physical": true,
"unit_of_size": "<string>",
"height": 123,
"width": 123,
"length": 123,
"unit_of_weight": "<string>",
"weight": "<string>",
"hs_code": "<string>"
},
"bundled_items": [
{}
],
"product_title": "<string>"
}
],
"ship_to": {
"id": 123,
"name": "<string>",
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"state": "<string>",
"subdivision_code": "<string>",
"postal_code": "<string>",
"country_code": "<string>",
"phone": "<string>",
"country_num_code": 123,
"default": true
},
"bill_to": {},
"attribution": {},
"agreements": [
{
"id": 123,
"title": "<string>",
"show_at_checkout": true,
"default_checked": true,
"subscription_only": true,
"standalone_on_checkout": true,
"show_path": "<string>",
"enrollment_pack_id": 123,
"required": true,
"content_digest": "<string>"
}
],
"country": {
"id": 123,
"name": "<string>",
"iso": "<string>",
"iso_name": "<string>",
"iso3": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"province_required": true,
"tax_enabled": true,
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"tax_standard_rate": 123
},
"company": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identity_sign_in_enabled": true,
"checkout_identity_enabled": true,
"id": 123,
"name": "<string>",
"favicon_url": "<string>",
"primary_domain_hostname": "<string>",
"subdomain": "<string>",
"logo_url": "<string>",
"fluid_shop": "<string>",
"collect_phone": true,
"require_phone": true,
"require_billing_zip": true,
"checkout_primary_button_color": "<string>",
"checkout_primary_text_color": "<string>",
"checkout_secondary_button_color": "<string>",
"checkout_secondary_text_color": "<string>",
"order_on_behalf": true,
"reward_points_enabled": true,
"reward_points_apply_to_subtotal": true,
"reward_points_label_singular": "<string>",
"reward_points_label_plural": "<string>",
"collect_sms_marketing": true,
"sms_terms_url": "<string>",
"sms_privacy_policy_url": "<string>",
"collect_email_marketing": true,
"bundle_subscriptions": true,
"hide_volume_on_customer_surfaces": true,
"isolated_payment_tokens": true,
"kount_environment": "sandbox",
"kount_client_id": "150953359757648"
},
"enrollment_pack": {},
"recurring": [
{
"subtotal": 123,
"subtotal_in_currency": "<string>",
"interval": 123,
"interval_unit": "<string>",
"interval_unit_identifier": "day",
"subtotal_for_display": "<string>",
"start_date": "<string>",
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
}
}
]
},
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {
"enrollment": true,
"id": 123,
"cart_token": "<string>",
"state": "<string>",
"state_revision": 1,
"population_status": "pending",
"email": "<string>",
"phone": "<string>",
"phone_dialable": true,
"sms_marketing_preselected": true,
"language_iso": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"currency_decimal_places": 123,
"type": "<string>",
"buyer_rep_id": 123,
"customer_id": 123,
"enrollment_pack_id": 123,
"enrollment_member_type": {
"id": "22c58158-7f6c-4f33-a033-32e259941684",
"slug": "rep",
"name": "Representative"
},
"email_marketing": true,
"sms_marketing": true,
"auto_apply_points": true,
"processed": true,
"payment_in_progress": true,
"payment_resume_url": "<string>",
"valid_for_checkout": true,
"valid_for_checkout_pre_payment": true,
"checkout_blockers": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"payment": "not_attempted"
}
],
"contains_subscription": true,
"vault_without_charge": true,
"payment_method_auto_assignable": true,
"requires_payment_method": true,
"requires_3ds": true,
"immutable_items": true,
"digital_only": true,
"points_enabled": true,
"messages": {},
"metadata": {},
"cv_total": "<string>",
"qv_total": "<string>",
"amount_total": 123,
"amount_total_in_currency": "<string>",
"sub_total": 123,
"sub_total_in_currency": "<string>",
"tax_total": 123,
"tax_exempt": true,
"tax_total_in_currency": "<string>",
"tax_total_for_display": "<string>",
"inclusive_shipping_tax": 123,
"shipping_total": 123,
"shipping_total_in_currency": "<string>",
"shipping_total_for_display": "<string>",
"discount_total": 123,
"discount_total_in_currency": "<string>",
"subtotal_after_discounts": 123,
"subtotal_after_discounts_in_currency": "<string>",
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"totals": {
"gross_subtotal": "<string>",
"gross_subtotal_in_currency": "<string>",
"net_subtotal": "<string>",
"net_subtotal_in_currency": "<string>",
"item_tax": "<string>",
"item_tax_in_currency": "<string>",
"shipping_net": "<string>",
"shipping_net_in_currency": "<string>",
"shipping_tax": "<string>",
"shipping_tax_in_currency": "<string>",
"total_tax": "<string>",
"total_tax_in_currency": "<string>",
"price_inclusive_of_tax": true,
"tax_label": "<string>"
},
"enrollment_fee": 123,
"enrollment_fee_in_currency": "<string>",
"transaction_fee": 123,
"transaction_fee_in_currency": "<string>",
"shipping_discount": 123,
"discount_codes": [
"<string>"
],
"product_discount_codes": [
"<string>"
],
"shipping_discount_codes": [
"<string>"
],
"customer_total_points": 123,
"customer_total_points_decimal": "120.0000",
"customer_total_points_in_currency": "<string>",
"points_applied": 123,
"points_applied_decimal": "120.0000",
"points_applied_amount_in_currency": "<string>",
"remaining_customer_points": 123,
"remaining_customer_points_decimal": "120.0000",
"remaining_customer_points_amount_in_currency": "<string>",
"remaining_cart_amount_after_points": 123,
"remaining_cart_amount_after_points_in_currency": "<string>",
"max_applicable_points": 123,
"points_unavailable_in_market": true,
"max_applicable_points_decimal": "120.0000",
"total_creditable_points": 123,
"total_creditable_points_decimal": "120.0000",
"shipping_address": {},
"billing_address": {},
"discount_breakdown": {
"internal_discounts": 123,
"external_discounts": 123,
"total_discounts": 123
},
"external_discount": {},
"buyer_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>",
"external_id": "<string>"
},
"buyer_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volume_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>"
},
"volume_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"available_shipping_methods": [
{
"id": "<string>",
"title": "<string>",
"price": 123,
"delivery_time_estimate": "<string>",
"price_label": "<string>"
}
],
"available_payment_methods": [
{}
],
"payment_unavailable_reason": "no_gateway_for_country",
"payment_account": {},
"shipping_method": {
"id": "<string>",
"name": "<string>"
},
"payment_method": {},
"items": [
{
"id": 123,
"title": "<string>",
"quantity": 123,
"price": "<string>",
"price_in_currency": "<string>",
"discount_amount": "<string>",
"discount_amount_in_currency": "<string>",
"tax": "<string>",
"tax_in_currency": "<string>",
"cv": "<string>",
"qv": "<string>",
"cv_total": "<string>",
"qv_total": "<string>",
"total": "<string>",
"total_in_currency": "<string>",
"line_total_in_currency": "<string>",
"total_after_discounts": "<string>",
"total_after_discounts_in_currency": "<string>",
"line_total_after_discounts_in_currency": "<string>",
"regular_line_total_in_currency": "<string>",
"unit_price_display_authoritative": true,
"price_unavailable": true,
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
},
"enrollment_pack_id": 123,
"subscription": true,
"subscription_plan_id": 123,
"subscription_plans": [
{}
],
"subscription_only": true,
"subscription_interval": 123,
"subscription_interval_unit": "<string>",
"subscription_interval_unit_identifier": "<string>",
"subscription_price": "<string>",
"subscription_price_in_currency": "<string>",
"subscription_start": "<string>",
"subscribe_and_save": "<string>",
"subscribe_and_save_in_currency": "<string>",
"subscribe_and_save_for_display": "<string>",
"display_to_customer": true,
"metadata": {},
"image_url": "<string>",
"free_item": true,
"allow_subscription": true,
"enrollment": true,
"errors": [
"<string>"
],
"creditable_points": 123,
"product": {},
"variant": {
"id": 123,
"title": "<string>",
"display_name": "<string>",
"image_url": "<string>",
"image_path": "<string>",
"sku": "<string>",
"primary_image": "<string>",
"price": 123,
"price_in_currency": "<string>",
"currency_code": "<string>",
"options": [
{
"title": "<string>",
"value": "<string>"
}
],
"physical": true,
"unit_of_size": "<string>",
"height": 123,
"width": 123,
"length": 123,
"unit_of_weight": "<string>",
"weight": "<string>",
"hs_code": "<string>"
},
"bundled_items": [
{}
],
"product_title": "<string>"
}
],
"ship_to": {
"id": 123,
"name": "<string>",
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"state": "<string>",
"subdivision_code": "<string>",
"postal_code": "<string>",
"country_code": "<string>",
"phone": "<string>",
"country_num_code": 123,
"default": true
},
"bill_to": {},
"attribution": {},
"agreements": [
{
"id": 123,
"title": "<string>",
"show_at_checkout": true,
"default_checked": true,
"subscription_only": true,
"standalone_on_checkout": true,
"show_path": "<string>",
"enrollment_pack_id": 123,
"required": true,
"content_digest": "<string>"
}
],
"country": {
"id": 123,
"name": "<string>",
"iso": "<string>",
"iso_name": "<string>",
"iso3": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"province_required": true,
"tax_enabled": true,
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"tax_standard_rate": 123
},
"company": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identity_sign_in_enabled": true,
"checkout_identity_enabled": true,
"id": 123,
"name": "<string>",
"favicon_url": "<string>",
"primary_domain_hostname": "<string>",
"subdomain": "<string>",
"logo_url": "<string>",
"fluid_shop": "<string>",
"collect_phone": true,
"require_phone": true,
"require_billing_zip": true,
"checkout_primary_button_color": "<string>",
"checkout_primary_text_color": "<string>",
"checkout_secondary_button_color": "<string>",
"checkout_secondary_text_color": "<string>",
"order_on_behalf": true,
"reward_points_enabled": true,
"reward_points_apply_to_subtotal": true,
"reward_points_label_singular": "<string>",
"reward_points_label_plural": "<string>",
"collect_sms_marketing": true,
"sms_terms_url": "<string>",
"sms_privacy_policy_url": "<string>",
"collect_email_marketing": true,
"bundle_subscriptions": true,
"hide_volume_on_customer_surfaces": true,
"isolated_payment_tokens": true,
"kount_environment": "sandbox",
"kount_client_id": "150953359757648"
},
"enrollment_pack": {},
"recurring": [
{
"subtotal": 123,
"subtotal_in_currency": "<string>",
"interval": 123,
"interval_unit": "<string>",
"interval_unit_identifier": "day",
"subtotal_for_display": "<string>",
"start_date": "<string>",
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
}
}
]
},
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {
"enrollment": true,
"id": 123,
"cart_token": "<string>",
"state": "<string>",
"state_revision": 1,
"population_status": "pending",
"email": "<string>",
"phone": "<string>",
"phone_dialable": true,
"sms_marketing_preselected": true,
"language_iso": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"currency_decimal_places": 123,
"type": "<string>",
"buyer_rep_id": 123,
"customer_id": 123,
"enrollment_pack_id": 123,
"enrollment_member_type": {
"id": "22c58158-7f6c-4f33-a033-32e259941684",
"slug": "rep",
"name": "Representative"
},
"email_marketing": true,
"sms_marketing": true,
"auto_apply_points": true,
"processed": true,
"payment_in_progress": true,
"payment_resume_url": "<string>",
"valid_for_checkout": true,
"valid_for_checkout_pre_payment": true,
"checkout_blockers": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"payment": "not_attempted"
}
],
"contains_subscription": true,
"vault_without_charge": true,
"payment_method_auto_assignable": true,
"requires_payment_method": true,
"requires_3ds": true,
"immutable_items": true,
"digital_only": true,
"points_enabled": true,
"messages": {},
"metadata": {},
"cv_total": "<string>",
"qv_total": "<string>",
"amount_total": 123,
"amount_total_in_currency": "<string>",
"sub_total": 123,
"sub_total_in_currency": "<string>",
"tax_total": 123,
"tax_exempt": true,
"tax_total_in_currency": "<string>",
"tax_total_for_display": "<string>",
"inclusive_shipping_tax": 123,
"shipping_total": 123,
"shipping_total_in_currency": "<string>",
"shipping_total_for_display": "<string>",
"discount_total": 123,
"discount_total_in_currency": "<string>",
"subtotal_after_discounts": 123,
"subtotal_after_discounts_in_currency": "<string>",
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"totals": {
"gross_subtotal": "<string>",
"gross_subtotal_in_currency": "<string>",
"net_subtotal": "<string>",
"net_subtotal_in_currency": "<string>",
"item_tax": "<string>",
"item_tax_in_currency": "<string>",
"shipping_net": "<string>",
"shipping_net_in_currency": "<string>",
"shipping_tax": "<string>",
"shipping_tax_in_currency": "<string>",
"total_tax": "<string>",
"total_tax_in_currency": "<string>",
"price_inclusive_of_tax": true,
"tax_label": "<string>"
},
"enrollment_fee": 123,
"enrollment_fee_in_currency": "<string>",
"transaction_fee": 123,
"transaction_fee_in_currency": "<string>",
"shipping_discount": 123,
"discount_codes": [
"<string>"
],
"product_discount_codes": [
"<string>"
],
"shipping_discount_codes": [
"<string>"
],
"customer_total_points": 123,
"customer_total_points_decimal": "120.0000",
"customer_total_points_in_currency": "<string>",
"points_applied": 123,
"points_applied_decimal": "120.0000",
"points_applied_amount_in_currency": "<string>",
"remaining_customer_points": 123,
"remaining_customer_points_decimal": "120.0000",
"remaining_customer_points_amount_in_currency": "<string>",
"remaining_cart_amount_after_points": 123,
"remaining_cart_amount_after_points_in_currency": "<string>",
"max_applicable_points": 123,
"points_unavailable_in_market": true,
"max_applicable_points_decimal": "120.0000",
"total_creditable_points": 123,
"total_creditable_points_decimal": "120.0000",
"shipping_address": {},
"billing_address": {},
"discount_breakdown": {
"internal_discounts": 123,
"external_discounts": 123,
"total_discounts": 123
},
"external_discount": {},
"buyer_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>",
"external_id": "<string>"
},
"buyer_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volume_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>"
},
"volume_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"available_shipping_methods": [
{
"id": "<string>",
"title": "<string>",
"price": 123,
"delivery_time_estimate": "<string>",
"price_label": "<string>"
}
],
"available_payment_methods": [
{}
],
"payment_unavailable_reason": "no_gateway_for_country",
"payment_account": {},
"shipping_method": {
"id": "<string>",
"name": "<string>"
},
"payment_method": {},
"items": [
{
"id": 123,
"title": "<string>",
"quantity": 123,
"price": "<string>",
"price_in_currency": "<string>",
"discount_amount": "<string>",
"discount_amount_in_currency": "<string>",
"tax": "<string>",
"tax_in_currency": "<string>",
"cv": "<string>",
"qv": "<string>",
"cv_total": "<string>",
"qv_total": "<string>",
"total": "<string>",
"total_in_currency": "<string>",
"line_total_in_currency": "<string>",
"total_after_discounts": "<string>",
"total_after_discounts_in_currency": "<string>",
"line_total_after_discounts_in_currency": "<string>",
"regular_line_total_in_currency": "<string>",
"unit_price_display_authoritative": true,
"price_unavailable": true,
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
},
"enrollment_pack_id": 123,
"subscription": true,
"subscription_plan_id": 123,
"subscription_plans": [
{}
],
"subscription_only": true,
"subscription_interval": 123,
"subscription_interval_unit": "<string>",
"subscription_interval_unit_identifier": "<string>",
"subscription_price": "<string>",
"subscription_price_in_currency": "<string>",
"subscription_start": "<string>",
"subscribe_and_save": "<string>",
"subscribe_and_save_in_currency": "<string>",
"subscribe_and_save_for_display": "<string>",
"display_to_customer": true,
"metadata": {},
"image_url": "<string>",
"free_item": true,
"allow_subscription": true,
"enrollment": true,
"errors": [
"<string>"
],
"creditable_points": 123,
"product": {},
"variant": {
"id": 123,
"title": "<string>",
"display_name": "<string>",
"image_url": "<string>",
"image_path": "<string>",
"sku": "<string>",
"primary_image": "<string>",
"price": 123,
"price_in_currency": "<string>",
"currency_code": "<string>",
"options": [
{
"title": "<string>",
"value": "<string>"
}
],
"physical": true,
"unit_of_size": "<string>",
"height": 123,
"width": 123,
"length": 123,
"unit_of_weight": "<string>",
"weight": "<string>",
"hs_code": "<string>"
},
"bundled_items": [
{}
],
"product_title": "<string>"
}
],
"ship_to": {
"id": 123,
"name": "<string>",
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"state": "<string>",
"subdivision_code": "<string>",
"postal_code": "<string>",
"country_code": "<string>",
"phone": "<string>",
"country_num_code": 123,
"default": true
},
"bill_to": {},
"attribution": {},
"agreements": [
{
"id": 123,
"title": "<string>",
"show_at_checkout": true,
"default_checked": true,
"subscription_only": true,
"standalone_on_checkout": true,
"show_path": "<string>",
"enrollment_pack_id": 123,
"required": true,
"content_digest": "<string>"
}
],
"country": {
"id": 123,
"name": "<string>",
"iso": "<string>",
"iso_name": "<string>",
"iso3": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"province_required": true,
"tax_enabled": true,
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"tax_standard_rate": 123
},
"company": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identity_sign_in_enabled": true,
"checkout_identity_enabled": true,
"id": 123,
"name": "<string>",
"favicon_url": "<string>",
"primary_domain_hostname": "<string>",
"subdomain": "<string>",
"logo_url": "<string>",
"fluid_shop": "<string>",
"collect_phone": true,
"require_phone": true,
"require_billing_zip": true,
"checkout_primary_button_color": "<string>",
"checkout_primary_text_color": "<string>",
"checkout_secondary_button_color": "<string>",
"checkout_secondary_text_color": "<string>",
"order_on_behalf": true,
"reward_points_enabled": true,
"reward_points_apply_to_subtotal": true,
"reward_points_label_singular": "<string>",
"reward_points_label_plural": "<string>",
"collect_sms_marketing": true,
"sms_terms_url": "<string>",
"sms_privacy_policy_url": "<string>",
"collect_email_marketing": true,
"bundle_subscriptions": true,
"hide_volume_on_customer_surfaces": true,
"isolated_payment_tokens": true,
"kount_environment": "sandbox",
"kount_client_id": "150953359757648"
},
"enrollment_pack": {},
"recurring": [
{
"subtotal": 123,
"subtotal_in_currency": "<string>",
"interval": 123,
"interval_unit": "<string>",
"interval_unit_identifier": "day",
"subtotal_for_display": "<string>",
"start_date": "<string>",
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
}
}
]
},
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}Authorizations
Bearer token authentication
Path Parameters
Body
application/json
Optional. Other submit-time fields (fraud session, device data,
browser info) are accepted as well. Send accepted_agreement_ids
whenever the cart has a required agreement, and always send the
expected_total / expected_currency pair.
Ids of the agreements the shopper accepted, from the cart's
agreements array. Required whenever the cart has a
required agreement: checkout refuses with 422 and
errors.agreements when any agreement the cart marks
required is missing from this list, unless the cart's
payment is already authorized or captured.
Example:
[658]
The version of each accepted agreement's text the client
showed the shopper: the agreement's id with the
content_digest from the same entry of the cart's
agreements array. Optional. When present, checkout
refuses with 422 and errors.agreements if any named
version is no longer the agreement's live text, so the
shopper is shown the new wording before being charged.
Show child attributes
Show child attributes
Example:
[
{
"id": 658,
"content_digest": "4f7f9a2d0c6b1e8e3a5d9c7b2f1e0d4c8b6a5f3e2d1c0b9a8f7e6d5c4b3a2918"
}
]
The cart total the client showed the shopper, as a decimal
string in the cart currency's major unit ("141.74"), taken
from amount_total of the cart the client last rendered.
Requires expected_currency.
Pattern:
^\d{1,12}(\.\d{1,5})?$Example:
"141.74"
ISO 4217 code of the currency the shopper was shown. Requires expected_total.
Example:
"USD"
Phone number to save on the cart before the checkout runs,
for a company whose checkout settings require one.
Intended for a cart that cannot take a PATCH: once a
wallet payment is approved the cart is authorized and
every cart mutation answers 410, so a shopper finishing
such a cart supplies the number here instead. Ignored on an
already-completed cart. A number that is still not dialable
leaves the checkout refused with phone in errors.
Example:
"+12125551005"
⌘I
Completes cart checkout
curl --request POST \
--url https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expected_total": "126.53",
"expected_currency": "USD"
}
'import requests
url = "https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout"
payload = {
"expected_total": "126.53",
"expected_currency": "USD"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({expected_total: '126.53', expected_currency: 'USD'})
};
fetch('https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'expected_total' => '126.53',
'expected_currency' => 'USD'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout"
payload := strings.NewReader("{\n \"expected_total\": \"126.53\",\n \"expected_currency\": \"USD\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"expected_total\": \"126.53\",\n \"expected_currency\": \"USD\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/public/v2025-06/commerce/carts/{cart_token}/checkout")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"expected_total\": \"126.53\",\n \"expected_currency\": \"USD\"\n}"
response = http.request(request)
puts response.read_body{
"order": {
"id": 58830,
"first_name": "Holly",
"last_name": "Flax",
"email": "holly.flax@dundermifflin.com",
"phone": "+15705550142",
"order_number": "DM-100482",
"token": "fo_3VbQ8mTk2WzR7nHp5LxYc9",
"status": "awaiting_shipment",
"order_status": "pending",
"financial_status": "paid",
"fulfillment_status": "unfulfilled",
"warehouse_id": null,
"order_type": "purchased",
"amount": "126.53",
"amount_in_base": "126.53",
"base_to_currency_rate": "1.0",
"refundable_amount": "126.53",
"note": null,
"recurring": [],
"order_confirmation_url": "https://checkout.fluid.app/orders/fo_3VbQ8mTk2WzR7nHp5LxYc9",
"currency_code": "USD",
"created_at": "2026-09-17T14:25:41Z",
"updated_at": "2026-09-17T14:25:43Z",
"metadata": {},
"external_id": null,
"enrollment_pack": null,
"enrollment_member_type": null,
"resulting_member_type": null,
"source": "web",
"points_applied": 0,
"free_shipping": false,
"discount_codes": [],
"created_subscriptions": []
},
"meta": {
"request_id": "c41e7a90-3b5d-4f28-9e61-8d2a0b7f5c13",
"shop_url": "https://shop.dundermifflin.com",
"timestamp": "2026-09-17T14:25:43Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {
"enrollment": true,
"id": 123,
"cart_token": "<string>",
"state": "<string>",
"state_revision": 1,
"population_status": "pending",
"email": "<string>",
"phone": "<string>",
"phone_dialable": true,
"sms_marketing_preselected": true,
"language_iso": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"currency_decimal_places": 123,
"type": "<string>",
"buyer_rep_id": 123,
"customer_id": 123,
"enrollment_pack_id": 123,
"enrollment_member_type": {
"id": "22c58158-7f6c-4f33-a033-32e259941684",
"slug": "rep",
"name": "Representative"
},
"email_marketing": true,
"sms_marketing": true,
"auto_apply_points": true,
"processed": true,
"payment_in_progress": true,
"payment_resume_url": "<string>",
"valid_for_checkout": true,
"valid_for_checkout_pre_payment": true,
"checkout_blockers": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"payment": "not_attempted"
}
],
"contains_subscription": true,
"vault_without_charge": true,
"payment_method_auto_assignable": true,
"requires_payment_method": true,
"requires_3ds": true,
"immutable_items": true,
"digital_only": true,
"points_enabled": true,
"messages": {},
"metadata": {},
"cv_total": "<string>",
"qv_total": "<string>",
"amount_total": 123,
"amount_total_in_currency": "<string>",
"sub_total": 123,
"sub_total_in_currency": "<string>",
"tax_total": 123,
"tax_exempt": true,
"tax_total_in_currency": "<string>",
"tax_total_for_display": "<string>",
"inclusive_shipping_tax": 123,
"shipping_total": 123,
"shipping_total_in_currency": "<string>",
"shipping_total_for_display": "<string>",
"discount_total": 123,
"discount_total_in_currency": "<string>",
"subtotal_after_discounts": 123,
"subtotal_after_discounts_in_currency": "<string>",
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"totals": {
"gross_subtotal": "<string>",
"gross_subtotal_in_currency": "<string>",
"net_subtotal": "<string>",
"net_subtotal_in_currency": "<string>",
"item_tax": "<string>",
"item_tax_in_currency": "<string>",
"shipping_net": "<string>",
"shipping_net_in_currency": "<string>",
"shipping_tax": "<string>",
"shipping_tax_in_currency": "<string>",
"total_tax": "<string>",
"total_tax_in_currency": "<string>",
"price_inclusive_of_tax": true,
"tax_label": "<string>"
},
"enrollment_fee": 123,
"enrollment_fee_in_currency": "<string>",
"transaction_fee": 123,
"transaction_fee_in_currency": "<string>",
"shipping_discount": 123,
"discount_codes": [
"<string>"
],
"product_discount_codes": [
"<string>"
],
"shipping_discount_codes": [
"<string>"
],
"customer_total_points": 123,
"customer_total_points_decimal": "120.0000",
"customer_total_points_in_currency": "<string>",
"points_applied": 123,
"points_applied_decimal": "120.0000",
"points_applied_amount_in_currency": "<string>",
"remaining_customer_points": 123,
"remaining_customer_points_decimal": "120.0000",
"remaining_customer_points_amount_in_currency": "<string>",
"remaining_cart_amount_after_points": 123,
"remaining_cart_amount_after_points_in_currency": "<string>",
"max_applicable_points": 123,
"points_unavailable_in_market": true,
"max_applicable_points_decimal": "120.0000",
"total_creditable_points": 123,
"total_creditable_points_decimal": "120.0000",
"shipping_address": {},
"billing_address": {},
"discount_breakdown": {
"internal_discounts": 123,
"external_discounts": 123,
"total_discounts": 123
},
"external_discount": {},
"buyer_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>",
"external_id": "<string>"
},
"buyer_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volume_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>"
},
"volume_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"available_shipping_methods": [
{
"id": "<string>",
"title": "<string>",
"price": 123,
"delivery_time_estimate": "<string>",
"price_label": "<string>"
}
],
"available_payment_methods": [
{}
],
"payment_unavailable_reason": "no_gateway_for_country",
"payment_account": {},
"shipping_method": {
"id": "<string>",
"name": "<string>"
},
"payment_method": {},
"items": [
{
"id": 123,
"title": "<string>",
"quantity": 123,
"price": "<string>",
"price_in_currency": "<string>",
"discount_amount": "<string>",
"discount_amount_in_currency": "<string>",
"tax": "<string>",
"tax_in_currency": "<string>",
"cv": "<string>",
"qv": "<string>",
"cv_total": "<string>",
"qv_total": "<string>",
"total": "<string>",
"total_in_currency": "<string>",
"line_total_in_currency": "<string>",
"total_after_discounts": "<string>",
"total_after_discounts_in_currency": "<string>",
"line_total_after_discounts_in_currency": "<string>",
"regular_line_total_in_currency": "<string>",
"unit_price_display_authoritative": true,
"price_unavailable": true,
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
},
"enrollment_pack_id": 123,
"subscription": true,
"subscription_plan_id": 123,
"subscription_plans": [
{}
],
"subscription_only": true,
"subscription_interval": 123,
"subscription_interval_unit": "<string>",
"subscription_interval_unit_identifier": "<string>",
"subscription_price": "<string>",
"subscription_price_in_currency": "<string>",
"subscription_start": "<string>",
"subscribe_and_save": "<string>",
"subscribe_and_save_in_currency": "<string>",
"subscribe_and_save_for_display": "<string>",
"display_to_customer": true,
"metadata": {},
"image_url": "<string>",
"free_item": true,
"allow_subscription": true,
"enrollment": true,
"errors": [
"<string>"
],
"creditable_points": 123,
"product": {},
"variant": {
"id": 123,
"title": "<string>",
"display_name": "<string>",
"image_url": "<string>",
"image_path": "<string>",
"sku": "<string>",
"primary_image": "<string>",
"price": 123,
"price_in_currency": "<string>",
"currency_code": "<string>",
"options": [
{
"title": "<string>",
"value": "<string>"
}
],
"physical": true,
"unit_of_size": "<string>",
"height": 123,
"width": 123,
"length": 123,
"unit_of_weight": "<string>",
"weight": "<string>",
"hs_code": "<string>"
},
"bundled_items": [
{}
],
"product_title": "<string>"
}
],
"ship_to": {
"id": 123,
"name": "<string>",
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"state": "<string>",
"subdivision_code": "<string>",
"postal_code": "<string>",
"country_code": "<string>",
"phone": "<string>",
"country_num_code": 123,
"default": true
},
"bill_to": {},
"attribution": {},
"agreements": [
{
"id": 123,
"title": "<string>",
"show_at_checkout": true,
"default_checked": true,
"subscription_only": true,
"standalone_on_checkout": true,
"show_path": "<string>",
"enrollment_pack_id": 123,
"required": true,
"content_digest": "<string>"
}
],
"country": {
"id": 123,
"name": "<string>",
"iso": "<string>",
"iso_name": "<string>",
"iso3": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"province_required": true,
"tax_enabled": true,
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"tax_standard_rate": 123
},
"company": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identity_sign_in_enabled": true,
"checkout_identity_enabled": true,
"id": 123,
"name": "<string>",
"favicon_url": "<string>",
"primary_domain_hostname": "<string>",
"subdomain": "<string>",
"logo_url": "<string>",
"fluid_shop": "<string>",
"collect_phone": true,
"require_phone": true,
"require_billing_zip": true,
"checkout_primary_button_color": "<string>",
"checkout_primary_text_color": "<string>",
"checkout_secondary_button_color": "<string>",
"checkout_secondary_text_color": "<string>",
"order_on_behalf": true,
"reward_points_enabled": true,
"reward_points_apply_to_subtotal": true,
"reward_points_label_singular": "<string>",
"reward_points_label_plural": "<string>",
"collect_sms_marketing": true,
"sms_terms_url": "<string>",
"sms_privacy_policy_url": "<string>",
"collect_email_marketing": true,
"bundle_subscriptions": true,
"hide_volume_on_customer_surfaces": true,
"isolated_payment_tokens": true,
"kount_environment": "sandbox",
"kount_client_id": "150953359757648"
},
"enrollment_pack": {},
"recurring": [
{
"subtotal": 123,
"subtotal_in_currency": "<string>",
"interval": 123,
"interval_unit": "<string>",
"interval_unit_identifier": "day",
"subtotal_for_display": "<string>",
"start_date": "<string>",
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
}
}
]
},
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {
"enrollment": true,
"id": 123,
"cart_token": "<string>",
"state": "<string>",
"state_revision": 1,
"population_status": "pending",
"email": "<string>",
"phone": "<string>",
"phone_dialable": true,
"sms_marketing_preselected": true,
"language_iso": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"currency_decimal_places": 123,
"type": "<string>",
"buyer_rep_id": 123,
"customer_id": 123,
"enrollment_pack_id": 123,
"enrollment_member_type": {
"id": "22c58158-7f6c-4f33-a033-32e259941684",
"slug": "rep",
"name": "Representative"
},
"email_marketing": true,
"sms_marketing": true,
"auto_apply_points": true,
"processed": true,
"payment_in_progress": true,
"payment_resume_url": "<string>",
"valid_for_checkout": true,
"valid_for_checkout_pre_payment": true,
"checkout_blockers": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"payment": "not_attempted"
}
],
"contains_subscription": true,
"vault_without_charge": true,
"payment_method_auto_assignable": true,
"requires_payment_method": true,
"requires_3ds": true,
"immutable_items": true,
"digital_only": true,
"points_enabled": true,
"messages": {},
"metadata": {},
"cv_total": "<string>",
"qv_total": "<string>",
"amount_total": 123,
"amount_total_in_currency": "<string>",
"sub_total": 123,
"sub_total_in_currency": "<string>",
"tax_total": 123,
"tax_exempt": true,
"tax_total_in_currency": "<string>",
"tax_total_for_display": "<string>",
"inclusive_shipping_tax": 123,
"shipping_total": 123,
"shipping_total_in_currency": "<string>",
"shipping_total_for_display": "<string>",
"discount_total": 123,
"discount_total_in_currency": "<string>",
"subtotal_after_discounts": 123,
"subtotal_after_discounts_in_currency": "<string>",
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"totals": {
"gross_subtotal": "<string>",
"gross_subtotal_in_currency": "<string>",
"net_subtotal": "<string>",
"net_subtotal_in_currency": "<string>",
"item_tax": "<string>",
"item_tax_in_currency": "<string>",
"shipping_net": "<string>",
"shipping_net_in_currency": "<string>",
"shipping_tax": "<string>",
"shipping_tax_in_currency": "<string>",
"total_tax": "<string>",
"total_tax_in_currency": "<string>",
"price_inclusive_of_tax": true,
"tax_label": "<string>"
},
"enrollment_fee": 123,
"enrollment_fee_in_currency": "<string>",
"transaction_fee": 123,
"transaction_fee_in_currency": "<string>",
"shipping_discount": 123,
"discount_codes": [
"<string>"
],
"product_discount_codes": [
"<string>"
],
"shipping_discount_codes": [
"<string>"
],
"customer_total_points": 123,
"customer_total_points_decimal": "120.0000",
"customer_total_points_in_currency": "<string>",
"points_applied": 123,
"points_applied_decimal": "120.0000",
"points_applied_amount_in_currency": "<string>",
"remaining_customer_points": 123,
"remaining_customer_points_decimal": "120.0000",
"remaining_customer_points_amount_in_currency": "<string>",
"remaining_cart_amount_after_points": 123,
"remaining_cart_amount_after_points_in_currency": "<string>",
"max_applicable_points": 123,
"points_unavailable_in_market": true,
"max_applicable_points_decimal": "120.0000",
"total_creditable_points": 123,
"total_creditable_points_decimal": "120.0000",
"shipping_address": {},
"billing_address": {},
"discount_breakdown": {
"internal_discounts": 123,
"external_discounts": 123,
"total_discounts": 123
},
"external_discount": {},
"buyer_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>",
"external_id": "<string>"
},
"buyer_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volume_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>"
},
"volume_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"available_shipping_methods": [
{
"id": "<string>",
"title": "<string>",
"price": 123,
"delivery_time_estimate": "<string>",
"price_label": "<string>"
}
],
"available_payment_methods": [
{}
],
"payment_unavailable_reason": "no_gateway_for_country",
"payment_account": {},
"shipping_method": {
"id": "<string>",
"name": "<string>"
},
"payment_method": {},
"items": [
{
"id": 123,
"title": "<string>",
"quantity": 123,
"price": "<string>",
"price_in_currency": "<string>",
"discount_amount": "<string>",
"discount_amount_in_currency": "<string>",
"tax": "<string>",
"tax_in_currency": "<string>",
"cv": "<string>",
"qv": "<string>",
"cv_total": "<string>",
"qv_total": "<string>",
"total": "<string>",
"total_in_currency": "<string>",
"line_total_in_currency": "<string>",
"total_after_discounts": "<string>",
"total_after_discounts_in_currency": "<string>",
"line_total_after_discounts_in_currency": "<string>",
"regular_line_total_in_currency": "<string>",
"unit_price_display_authoritative": true,
"price_unavailable": true,
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
},
"enrollment_pack_id": 123,
"subscription": true,
"subscription_plan_id": 123,
"subscription_plans": [
{}
],
"subscription_only": true,
"subscription_interval": 123,
"subscription_interval_unit": "<string>",
"subscription_interval_unit_identifier": "<string>",
"subscription_price": "<string>",
"subscription_price_in_currency": "<string>",
"subscription_start": "<string>",
"subscribe_and_save": "<string>",
"subscribe_and_save_in_currency": "<string>",
"subscribe_and_save_for_display": "<string>",
"display_to_customer": true,
"metadata": {},
"image_url": "<string>",
"free_item": true,
"allow_subscription": true,
"enrollment": true,
"errors": [
"<string>"
],
"creditable_points": 123,
"product": {},
"variant": {
"id": 123,
"title": "<string>",
"display_name": "<string>",
"image_url": "<string>",
"image_path": "<string>",
"sku": "<string>",
"primary_image": "<string>",
"price": 123,
"price_in_currency": "<string>",
"currency_code": "<string>",
"options": [
{
"title": "<string>",
"value": "<string>"
}
],
"physical": true,
"unit_of_size": "<string>",
"height": 123,
"width": 123,
"length": 123,
"unit_of_weight": "<string>",
"weight": "<string>",
"hs_code": "<string>"
},
"bundled_items": [
{}
],
"product_title": "<string>"
}
],
"ship_to": {
"id": 123,
"name": "<string>",
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"state": "<string>",
"subdivision_code": "<string>",
"postal_code": "<string>",
"country_code": "<string>",
"phone": "<string>",
"country_num_code": 123,
"default": true
},
"bill_to": {},
"attribution": {},
"agreements": [
{
"id": 123,
"title": "<string>",
"show_at_checkout": true,
"default_checked": true,
"subscription_only": true,
"standalone_on_checkout": true,
"show_path": "<string>",
"enrollment_pack_id": 123,
"required": true,
"content_digest": "<string>"
}
],
"country": {
"id": 123,
"name": "<string>",
"iso": "<string>",
"iso_name": "<string>",
"iso3": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"province_required": true,
"tax_enabled": true,
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"tax_standard_rate": 123
},
"company": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identity_sign_in_enabled": true,
"checkout_identity_enabled": true,
"id": 123,
"name": "<string>",
"favicon_url": "<string>",
"primary_domain_hostname": "<string>",
"subdomain": "<string>",
"logo_url": "<string>",
"fluid_shop": "<string>",
"collect_phone": true,
"require_phone": true,
"require_billing_zip": true,
"checkout_primary_button_color": "<string>",
"checkout_primary_text_color": "<string>",
"checkout_secondary_button_color": "<string>",
"checkout_secondary_text_color": "<string>",
"order_on_behalf": true,
"reward_points_enabled": true,
"reward_points_apply_to_subtotal": true,
"reward_points_label_singular": "<string>",
"reward_points_label_plural": "<string>",
"collect_sms_marketing": true,
"sms_terms_url": "<string>",
"sms_privacy_policy_url": "<string>",
"collect_email_marketing": true,
"bundle_subscriptions": true,
"hide_volume_on_customer_surfaces": true,
"isolated_payment_tokens": true,
"kount_environment": "sandbox",
"kount_client_id": "150953359757648"
},
"enrollment_pack": {},
"recurring": [
{
"subtotal": 123,
"subtotal_in_currency": "<string>",
"interval": 123,
"interval_unit": "<string>",
"interval_unit_identifier": "day",
"subtotal_for_display": "<string>",
"start_date": "<string>",
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
}
}
]
},
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"shop_url": "<string>",
"cart": {
"enrollment": true,
"id": 123,
"cart_token": "<string>",
"state": "<string>",
"state_revision": 1,
"population_status": "pending",
"email": "<string>",
"phone": "<string>",
"phone_dialable": true,
"sms_marketing_preselected": true,
"language_iso": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"currency_decimal_places": 123,
"type": "<string>",
"buyer_rep_id": 123,
"customer_id": 123,
"enrollment_pack_id": 123,
"enrollment_member_type": {
"id": "22c58158-7f6c-4f33-a033-32e259941684",
"slug": "rep",
"name": "Representative"
},
"email_marketing": true,
"sms_marketing": true,
"auto_apply_points": true,
"processed": true,
"payment_in_progress": true,
"payment_resume_url": "<string>",
"valid_for_checkout": true,
"valid_for_checkout_pre_payment": true,
"checkout_blockers": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"payment": "not_attempted"
}
],
"contains_subscription": true,
"vault_without_charge": true,
"payment_method_auto_assignable": true,
"requires_payment_method": true,
"requires_3ds": true,
"immutable_items": true,
"digital_only": true,
"points_enabled": true,
"messages": {},
"metadata": {},
"cv_total": "<string>",
"qv_total": "<string>",
"amount_total": 123,
"amount_total_in_currency": "<string>",
"sub_total": 123,
"sub_total_in_currency": "<string>",
"tax_total": 123,
"tax_exempt": true,
"tax_total_in_currency": "<string>",
"tax_total_for_display": "<string>",
"inclusive_shipping_tax": 123,
"shipping_total": 123,
"shipping_total_in_currency": "<string>",
"shipping_total_for_display": "<string>",
"discount_total": 123,
"discount_total_in_currency": "<string>",
"subtotal_after_discounts": 123,
"subtotal_after_discounts_in_currency": "<string>",
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"totals": {
"gross_subtotal": "<string>",
"gross_subtotal_in_currency": "<string>",
"net_subtotal": "<string>",
"net_subtotal_in_currency": "<string>",
"item_tax": "<string>",
"item_tax_in_currency": "<string>",
"shipping_net": "<string>",
"shipping_net_in_currency": "<string>",
"shipping_tax": "<string>",
"shipping_tax_in_currency": "<string>",
"total_tax": "<string>",
"total_tax_in_currency": "<string>",
"price_inclusive_of_tax": true,
"tax_label": "<string>"
},
"enrollment_fee": 123,
"enrollment_fee_in_currency": "<string>",
"transaction_fee": 123,
"transaction_fee_in_currency": "<string>",
"shipping_discount": 123,
"discount_codes": [
"<string>"
],
"product_discount_codes": [
"<string>"
],
"shipping_discount_codes": [
"<string>"
],
"customer_total_points": 123,
"customer_total_points_decimal": "120.0000",
"customer_total_points_in_currency": "<string>",
"points_applied": 123,
"points_applied_decimal": "120.0000",
"points_applied_amount_in_currency": "<string>",
"remaining_customer_points": 123,
"remaining_customer_points_decimal": "120.0000",
"remaining_customer_points_amount_in_currency": "<string>",
"remaining_cart_amount_after_points": 123,
"remaining_cart_amount_after_points_in_currency": "<string>",
"max_applicable_points": 123,
"points_unavailable_in_market": true,
"max_applicable_points_decimal": "120.0000",
"total_creditable_points": 123,
"total_creditable_points_decimal": "120.0000",
"shipping_address": {},
"billing_address": {},
"discount_breakdown": {
"internal_discounts": 123,
"external_discounts": 123,
"total_discounts": 123
},
"external_discount": {},
"buyer_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>",
"external_id": "<string>"
},
"buyer_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"volume_rep": {
"id": 123,
"email": "<string>",
"full_name": "<string>",
"image_url": "<string>"
},
"volume_rep_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"available_shipping_methods": [
{
"id": "<string>",
"title": "<string>",
"price": 123,
"delivery_time_estimate": "<string>",
"price_label": "<string>"
}
],
"available_payment_methods": [
{}
],
"payment_unavailable_reason": "no_gateway_for_country",
"payment_account": {},
"shipping_method": {
"id": "<string>",
"name": "<string>"
},
"payment_method": {},
"items": [
{
"id": 123,
"title": "<string>",
"quantity": 123,
"price": "<string>",
"price_in_currency": "<string>",
"discount_amount": "<string>",
"discount_amount_in_currency": "<string>",
"tax": "<string>",
"tax_in_currency": "<string>",
"cv": "<string>",
"qv": "<string>",
"cv_total": "<string>",
"qv_total": "<string>",
"total": "<string>",
"total_in_currency": "<string>",
"line_total_in_currency": "<string>",
"total_after_discounts": "<string>",
"total_after_discounts_in_currency": "<string>",
"line_total_after_discounts_in_currency": "<string>",
"regular_line_total_in_currency": "<string>",
"unit_price_display_authoritative": true,
"price_unavailable": true,
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
},
"enrollment_pack_id": 123,
"subscription": true,
"subscription_plan_id": 123,
"subscription_plans": [
{}
],
"subscription_only": true,
"subscription_interval": 123,
"subscription_interval_unit": "<string>",
"subscription_interval_unit_identifier": "<string>",
"subscription_price": "<string>",
"subscription_price_in_currency": "<string>",
"subscription_start": "<string>",
"subscribe_and_save": "<string>",
"subscribe_and_save_in_currency": "<string>",
"subscribe_and_save_for_display": "<string>",
"display_to_customer": true,
"metadata": {},
"image_url": "<string>",
"free_item": true,
"allow_subscription": true,
"enrollment": true,
"errors": [
"<string>"
],
"creditable_points": 123,
"product": {},
"variant": {
"id": 123,
"title": "<string>",
"display_name": "<string>",
"image_url": "<string>",
"image_path": "<string>",
"sku": "<string>",
"primary_image": "<string>",
"price": 123,
"price_in_currency": "<string>",
"currency_code": "<string>",
"options": [
{
"title": "<string>",
"value": "<string>"
}
],
"physical": true,
"unit_of_size": "<string>",
"height": 123,
"width": 123,
"length": 123,
"unit_of_weight": "<string>",
"weight": "<string>",
"hs_code": "<string>"
},
"bundled_items": [
{}
],
"product_title": "<string>"
}
],
"ship_to": {
"id": 123,
"name": "<string>",
"address1": "<string>",
"address2": "<string>",
"address3": "<string>",
"city": "<string>",
"state": "<string>",
"subdivision_code": "<string>",
"postal_code": "<string>",
"country_code": "<string>",
"phone": "<string>",
"country_num_code": 123,
"default": true
},
"bill_to": {},
"attribution": {},
"agreements": [
{
"id": 123,
"title": "<string>",
"show_at_checkout": true,
"default_checked": true,
"subscription_only": true,
"standalone_on_checkout": true,
"show_path": "<string>",
"enrollment_pack_id": 123,
"required": true,
"content_digest": "<string>"
}
],
"country": {
"id": 123,
"name": "<string>",
"iso": "<string>",
"iso_name": "<string>",
"iso3": "<string>",
"currency_code": "<string>",
"currency_symbol": "<string>",
"province_required": true,
"tax_enabled": true,
"price_inclusive_of_tax": true,
"price_inclusive_tax_name": "<string>",
"tax_standard_rate": 123
},
"company": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"identity_sign_in_enabled": true,
"checkout_identity_enabled": true,
"id": 123,
"name": "<string>",
"favicon_url": "<string>",
"primary_domain_hostname": "<string>",
"subdomain": "<string>",
"logo_url": "<string>",
"fluid_shop": "<string>",
"collect_phone": true,
"require_phone": true,
"require_billing_zip": true,
"checkout_primary_button_color": "<string>",
"checkout_primary_text_color": "<string>",
"checkout_secondary_button_color": "<string>",
"checkout_secondary_text_color": "<string>",
"order_on_behalf": true,
"reward_points_enabled": true,
"reward_points_apply_to_subtotal": true,
"reward_points_label_singular": "<string>",
"reward_points_label_plural": "<string>",
"collect_sms_marketing": true,
"sms_terms_url": "<string>",
"sms_privacy_policy_url": "<string>",
"collect_email_marketing": true,
"bundle_subscriptions": true,
"hide_volume_on_customer_surfaces": true,
"isolated_payment_tokens": true,
"kount_environment": "sandbox",
"kount_client_id": "150953359757648"
},
"enrollment_pack": {},
"recurring": [
{
"subtotal": 123,
"subtotal_in_currency": "<string>",
"interval": 123,
"interval_unit": "<string>",
"interval_unit_identifier": "day",
"subtotal_for_display": "<string>",
"start_date": "<string>",
"subscription_start_notice": {
"message": "We never bill on the 29th to the 31st, so your first order bills on the 28th.",
"moved_from": "2026-11-30"
}
}
]
},
"code": "<string>",
"payment_uuid": "<string>",
"error_details": [
{
"code": "<string>",
"field": "<string>",
"payment": "not_attempted",
"message": "<string>"
}
],
"coded_recovery": true
}
}