Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Expose `checkout_steps` in Orders API (#13736)
Damian Legawiece7afb85ab505
diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yamlindex d0aef96c16..c1f7cb805b 100644--- a/docs/api-reference/store.yaml+++ b/docs/api-reference/store.yaml@@ -647,14 +647,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjRjODFkODk3LTcwZTMtNGZhMC04YTFmLWJjNzlhMzNiYTY5YiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyNzA5MTcxfQ.hnd1VlfoJu4G1DrIukQL1clrt9jbSmIcCjehNpZ_fuE+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImQ3ZTVhMjljLTU1Y2UtNDAxNi1hZDZmLWRiMmU5ZjY3NTA4MSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyNzQyODY5fQ.ZRet-XBHnlKp9eLnyY25uU3yerCNZ5j4HtUQRU8duwkuser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Micheal- last_name: Balistreri- created_at: '2026-03-05T10:12:50.891Z'- updated_at: '2026-03-05T10:12:50.891Z'+ first_name: Rachel+ last_name: McGlynn+ created_at: '2026-03-05T19:34:29.189Z'+ updated_at: '2026-03-05T19:34:29.189Z'addresses: []default_billing_address:default_shipping_address:@@ -727,14 +727,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjAxZjZhYWZkLTYyYjYtNDdjZS05ZGVjLWY0NTViMTI3NDJkZCIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyNzA5MTcyfQ.BDWAd0gWZi0deHpkyYfZqRyl86MdGJ1qJmhIK9bMxyE+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjVkODAwMWI2LThmYTItNGM3Yy1iYzg0LTEzYzUxZDRmOGQyMiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyNzQyODcwfQ.-bZMS2MquOp_XWdBB3PcZej1HR58csH_36d2KSPSA9Yuser:id: cus_UkLWZg9DAJemail: [email protected]first_name: Johnlast_name: Doe- created_at: '2026-03-05T10:12:52.344Z'- updated_at: '2026-03-05T10:12:52.344Z'+ created_at: '2026-03-05T19:34:30.609Z'+ updated_at: '2026-03-05T19:34:30.609Z'addresses: []default_billing_address:default_shipping_address:@@ -820,14 +820,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjFiMTJmYjk0LWZlYjUtNDMyMS1iOGNkLWIzNmJiNGRkNjBlMiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyNzA5MTcyfQ.AbD4LOwCN-Te2bPBUAHZYWi8q-6xlInBUycDW9EmyT4+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImFiN2IxMzg1LTJkYTYtNDQ2Yy1hZGFlLTVkYWM3YzEzZWQ0OSIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyNzQyODcxfQ.fK1h_EEvHr82Cvm2ZUWVlaTEy39uciPhvyeHbQH8OZkuser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Monty- last_name: Berge- created_at: '2026-03-05T10:12:52.904Z'- updated_at: '2026-03-05T10:12:52.904Z'+ first_name: Ethelyn+ last_name: Dach+ created_at: '2026-03-05T19:34:31.174Z'+ updated_at: '2026-03-05T19:34:31.174Z'addresses: []default_billing_address:default_shipping_address:@@ -891,9 +891,13 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R935471658+ number: R475457113state: cart- token: "-E3d_5Ejn1imZYqw-tENWw1772705573567"+ checkout_steps:+ - address+ - delivery+ - complete+ token: fYkadPtBLE5WUtgNo87V2A1772739271810email:special_instructions:currency: USD@@ -919,8 +923,8 @@ paths:total: '0.0'display_total: "$0.00"completed_at:- created_at: '2026-03-05T10:12:53.568Z'- updated_at: '2026-03-05T10:12:53.568Z'+ created_at: '2026-03-05T19:34:31.811Z'+ updated_at: '2026-03-05T19:34:31.811Z'order_promotions: []line_items: []shipments: []@@ -1026,10 +1030,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R625333279+ number: R594344076state: cart- token: vWWRUi67ycMc38uJn9HcHjYViCHZPPL1qRb- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: P3hU3WdubZQdKZ8sk8bAaU2dtLdqk8fypps+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1054,16 +1063,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:12:54.647Z'- updated_at: '2026-03-05T10:12:54.720Z'+ created_at: '2026-03-05T19:34:32.855Z'+ updated_at: '2026-03-05T19:34:32.909Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 23466- slug: product-23466+ name: Product 28640+ slug: product-28640options_text: ''price: '10.0'display_price: "$10.00"@@ -1082,23 +1091,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:12:54.690Z'- updated_at: '2026-03-05T10:12:54.690Z'+ created_at: '2026-03-05T19:34:32.886Z'+ updated_at: '2026-03-05T19:34:32.886Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H16887874614+ number: H16418260736state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:12:54.696Z'- updated_at: '2026-03-05T10:12:54.717Z'+ created_at: '2026-03-05T19:34:32.892Z'+ updated_at: '2026-03-05T19:34:32.907Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1106,7 +1115,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_41- name: Lesha Considine+ name: Edythe Streichaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1224,10 +1233,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R767761099+ number: R549110979state: cart- token: JNzv8nEcTLnNMvhB9SnraBJSpoMHg9SKS5E- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: tHAvReKQMRLyg8wq2RgURRQDuHHjqQhRZg8+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1252,16 +1266,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:12:55.302Z'- updated_at: '2026-03-05T10:12:55.361Z'+ created_at: '2026-03-05T19:34:33.516Z'+ updated_at: '2026-03-05T19:34:33.571Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 35507- slug: product-35507+ name: Product 3613+ slug: product-3613options_text: ''price: '10.0'display_price: "$10.00"@@ -1280,23 +1294,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:12:55.337Z'- updated_at: '2026-03-05T10:12:55.337Z'+ created_at: '2026-03-05T19:34:33.549Z'+ updated_at: '2026-03-05T19:34:33.549Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H44992416560+ number: H65042707991state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:12:55.342Z'- updated_at: '2026-03-05T10:12:55.359Z'+ created_at: '2026-03-05T19:34:33.555Z'+ updated_at: '2026-03-05T19:34:33.568Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1304,7 +1318,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_45- name: Karma VonRueden+ name: Monserrate Lakinaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1579,10 +1593,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R795624609+ number: R241156833state: cart- token: xztU4oAb2fgekg7W4edpWu8XtDqSEJNxeLm- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: Z77bRNqvXpUYgs4tdKc1B2zy3W2r12RmdV7+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1607,16 +1626,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:12:59.254Z'- updated_at: '2026-03-05T10:12:59.391Z'+ created_at: '2026-03-05T19:34:37.389Z'+ updated_at: '2026-03-05T19:34:37.517Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 86861- slug: product-86861+ name: Product 82228+ slug: product-82228options_text: ''price: '10.0'display_price: "$10.00"@@ -1635,23 +1654,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:12:59.293Z'- updated_at: '2026-03-05T10:12:59.293Z'+ created_at: '2026-03-05T19:34:37.424Z'+ updated_at: '2026-03-05T19:34:37.424Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H76099278715+ number: H51146050064state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:12:59.301Z'- updated_at: '2026-03-05T10:12:59.319Z'+ created_at: '2026-03-05T19:34:37.429Z'+ updated_at: '2026-03-05T19:34:37.445Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1659,7 +1678,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_65- name: Geoffrey Streich+ name: Felton Jastaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1681,12 +1700,12 @@ paths:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJstate: checkout- response_code: 1-SC-20260305101259379006- number: PCWLUSFQ+ response_code: 1-SC-20260305193437505334+ number: PF68Z57Famount: '50.0'display_amount: "$50.00"- created_at: '2026-03-05T10:12:59.384Z'- updated_at: '2026-03-05T10:12:59.384Z'+ created_at: '2026-03-05T19:34:37.510Z'+ updated_at: '2026-03-05T19:34:37.510Z'source_type: store_creditsource_id: credit_UkLWZg9DAJsource:@@ -1838,10 +1857,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R279710927+ number: R409972656state: cart- token: rNhi5SnCA41uVJftQRdgB59whL18tfcXCPN- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: tjq8gAjv6yDfPNx567VTuY7fRU55FwPVQJD+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1866,16 +1890,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:01.223Z'- updated_at: '2026-03-05T10:13:01.362Z'+ created_at: '2026-03-05T19:34:39.412Z'+ updated_at: '2026-03-05T19:34:39.561Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 118355- slug: product-118355+ name: Product 112162+ slug: product-112162options_text: ''price: '10.0'display_price: "$10.00"@@ -1894,23 +1918,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:01.260Z'- updated_at: '2026-03-05T10:13:01.356Z'+ created_at: '2026-03-05T19:34:39.452Z'+ updated_at: '2026-03-05T19:34:39.554Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H23651198973+ number: H84508037593state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:01.266Z'- updated_at: '2026-03-05T10:13:01.282Z'+ created_at: '2026-03-05T19:34:39.460Z'+ updated_at: '2026-03-05T19:34:39.476Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1918,7 +1942,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_77- name: Jami Rau+ name: Dawn Keebleraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2313,10 +2337,15 @@ paths:example:data:- id: or_UkLWZg9DAJ- number: R651940569+ number: R664706640state: cart- token: PzwGmqwa4ARByDTDVmug7B5Gw7LscyWY9cs- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: DGLiUqJH8ZD6LGs8NUxDUU8VE4ZoPmw7CPR+ email: [email protected]special_instructions:currency: USDlocale: en@@ -2341,16 +2370,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:06.071Z'- updated_at: '2026-03-05T10:13:06.141Z'+ created_at: '2026-03-05T19:34:44.529Z'+ updated_at: '2026-03-05T19:34:44.637Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 135089- slug: product-135089+ name: Product 132459+ slug: product-132459options_text: ''price: '10.0'display_price: "$10.00"@@ -2369,23 +2398,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:06.115Z'- updated_at: '2026-03-05T10:13:06.115Z'+ created_at: '2026-03-05T19:34:44.595Z'+ updated_at: '2026-03-05T19:34:44.595Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H52521760738+ number: H69602176809state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:06.122Z'- updated_at: '2026-03-05T10:13:06.139Z'+ created_at: '2026-03-05T19:34:44.605Z'+ updated_at: '2026-03-05T19:34:44.633Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -2393,7 +2422,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_100- name: Annamarie Mueller+ name: Manuel Kessleraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2518,11 +2547,11 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Milan- last_name: Beatty- created_at: '2026-03-05T10:13:07.129Z'- updated_at: '2026-03-05T10:13:07.402Z'+ email: [email protected]+ first_name: Irene+ last_name: Fritsch+ created_at: '2026-03-05T19:34:45.676Z'+ updated_at: '2026-03-05T19:34:45.975Z'addresses:- id: addr_gbHJdmfrXBfirstname: John@@ -2645,11 +2674,11 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Updatedlast_name: Name- created_at: '2026-03-05T10:13:07.701Z'- updated_at: '2026-03-05T10:13:07.989Z'+ created_at: '2026-03-05T19:34:46.301Z'+ updated_at: '2026-03-05T19:34:46.790Z'addresses:- id: addr_gbHJdmfrXBfirstname: John@@ -2862,7 +2891,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: 49C37BFEB54BA9AE+ code: E33CCC319BA77576state: activecurrency: USDamount: '10.0'@@ -2876,8 +2905,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-03-05T10:13:11.189Z'- updated_at: '2026-03-05T10:13:11.189Z'+ created_at: '2026-03-05T19:34:51.173Z'+ updated_at: '2026-03-05T19:34:51.173Z'meta:page: 1limit: 25@@ -2953,7 +2982,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: E1A8520D65465E70+ code: 65A22C3E1596C48Estate: activecurrency: USDamount: '10.0'@@ -2967,8 +2996,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-03-05T10:13:12.319Z'- updated_at: '2026-03-05T10:13:12.319Z'+ created_at: '2026-03-05T19:34:52.314Z'+ updated_at: '2026-03-05T19:34:52.314Z'schema:"$ref": "#/components/schemas/StoreGiftCard"'404':@@ -3046,10 +3075,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R504722406+ number: R769301163state: cart- token: QSj7Zxy1tQHMsEGp3qjDqqxmrFPL1eELjZk- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: 9fo7RYTAHqUuaDtGqTe8G6vMSRoBkmQL6u7+ email: [email protected]special_instructions:currency: USDlocale: en@@ -3074,16 +3108,16 @@ paths:total: '29.99'display_total: "$29.99"completed_at:- created_at: '2026-03-05T10:13:14.118Z'- updated_at: '2026-03-05T10:13:14.248Z'+ created_at: '2026-03-05T19:34:54.118Z'+ updated_at: '2026-03-05T19:34:54.230Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 235990- slug: product-235990+ name: Product 237632+ slug: product-237632options_text: ''price: '10.0'display_price: "$10.00"@@ -3102,8 +3136,8 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:14.152Z'- updated_at: '2026-03-05T10:13:14.152Z'+ created_at: '2026-03-05T19:34:54.155Z'+ updated_at: '2026-03-05T19:34:54.155Z'compare_at_amount:thumbnail_url:option_values: []@@ -3112,8 +3146,8 @@ paths:variant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 24677- slug: product-24677+ name: Product 249766+ slug: product-249766options_text: ''price: '19.99'display_price: "$19.99"@@ -3132,8 +3166,8 @@ paths:discounted_amount: '19.99'display_discounted_amount: "$19.99"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:14.216Z'- updated_at: '2026-03-05T10:13:14.216Z'+ created_at: '2026-03-05T19:34:54.205Z'+ updated_at: '2026-03-05T19:34:54.205Z'compare_at_amount:thumbnail_url:option_values: []@@ -3253,10 +3287,14 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R289193947+ number: R376886314state: cart- token: znvNeiyfM5khVnD7pwkM8Q5BvJkVNfW8FC9- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - complete+ token: XegcG7bcayaFKJwAn7zsjbYhXGZYRAc7MGx+ email: [email protected]special_instructions:currency: USDlocale: en@@ -3281,16 +3319,16 @@ paths:total: '0.0'display_total: "$0.00"completed_at:- created_at: '2026-03-05T10:13:16.651Z'- updated_at: '2026-03-05T10:13:16.690Z'+ created_at: '2026-03-05T19:34:56.757Z'+ updated_at: '2026-03-05T19:34:56.787Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 283574- slug: product-283574+ name: Product 281107+ slug: product-281107options_text: ''price: '10.0'display_price: "$10.00"@@ -3309,8 +3347,8 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:16.690Z'- updated_at: '2026-03-05T10:13:16.710Z'+ created_at: '2026-03-05T19:34:56.787Z'+ updated_at: '2026-03-05T19:34:56.803Z'compare_at_amount:thumbnail_url:option_values: []@@ -3409,10 +3447,14 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R225243737+ number: R364273558state: cart- token: y8HRqKBaF1yhrSWd2mSbTnuyNcaP5aNhC2P- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - complete+ token: pTZg39v66xmCodQazRSPVLK1x9889Q88Wfx+ email: [email protected]special_instructions:currency: USDlocale: en@@ -3437,8 +3479,8 @@ paths:total: '0.0'display_total: "$0.00"completed_at:- created_at: '2026-03-05T10:13:17.302Z'- updated_at: '2026-03-05T10:13:17.366Z'+ created_at: '2026-03-05T19:34:57.377Z'+ updated_at: '2026-03-05T19:34:57.449Z'order_promotions: []line_items: []shipments: []@@ -3943,9 +3985,14 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R146344806+ number: R304888371state: cart- token: xarJrfj83gLuxSHx9j9xRT8ZrEtKxvyWKBh+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: f8uR7Ep3Bzds1QBBwj2a6NanYpgEzMPAkV2email:special_instructions:currency: USD@@ -3971,16 +4018,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:19.759Z'- updated_at: '2026-03-05T10:13:19.831Z'+ created_at: '2026-03-05T19:34:59.824Z'+ updated_at: '2026-03-05T19:34:59.884Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 338954- slug: product-338954+ name: Product 336747+ slug: product-336747options_text: ''price: '10.0'display_price: "$10.00"@@ -3999,23 +4046,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:19.789Z'- updated_at: '2026-03-05T10:13:19.789Z'+ created_at: '2026-03-05T19:34:59.862Z'+ updated_at: '2026-03-05T19:34:59.862Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_gbHJdmfrXB- number: H26748896837+ number: H47595143173state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:19.802Z'- updated_at: '2026-03-05T10:13:19.819Z'+ created_at: '2026-03-05T19:34:59.870Z'+ updated_at: '2026-03-05T19:34:59.882Z'shipping_method:id: shpm_gbHJdmfrXBname: UPS Ground@@ -4023,7 +4070,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_159- name: Kelly Douglas+ name: Ralph Lindgrenaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4158,10 +4205,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R155308648+ number: R222155112state: cart- token: RUAgF9xa1MCZDMfwiDLHfQjYFek3cqq9rAL- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: 7yzitew4SQycNSiHXPEZJWdUFk5B6UsgS4F+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4186,16 +4238,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:22.610Z'- updated_at: '2026-03-05T10:13:22.695Z'+ created_at: '2026-03-05T19:35:02.574Z'+ updated_at: '2026-03-05T19:35:02.639Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 375684- slug: product-375684+ name: Product 372901+ slug: product-372901options_text: ''price: '10.0'display_price: "$10.00"@@ -4214,23 +4266,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:22.647Z'- updated_at: '2026-03-05T10:13:22.647Z'+ created_at: '2026-03-05T19:35:02.605Z'+ updated_at: '2026-03-05T19:35:02.605Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H63840183543+ number: H94374952613state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:22.653Z'- updated_at: '2026-03-05T10:13:22.670Z'+ created_at: '2026-03-05T19:35:02.610Z'+ updated_at: '2026-03-05T19:35:02.623Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -4238,7 +4290,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_178- name: Donnie Powlowski+ name: Stella Metzaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4449,10 +4501,15 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R471304745+ number: R594040326state: address- token: WeB52fhwS8oT3HpbCASPnq6BVDd7fY4Tb9E- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: 3Md1cjUPKzCJypAWM1r5VJsfSU556MfUmHX+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4477,16 +4534,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:24.039Z'- updated_at: '2026-03-05T10:13:24.112Z'+ created_at: '2026-03-05T19:35:03.964Z'+ updated_at: '2026-03-05T19:35:04.025Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 418691- slug: product-418691+ name: Product 414759+ slug: product-414759options_text: ''price: '10.0'display_price: "$10.00"@@ -4505,23 +4562,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:24.071Z'- updated_at: '2026-03-05T10:13:24.071Z'+ created_at: '2026-03-05T19:35:03.990Z'+ updated_at: '2026-03-05T19:35:03.990Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_gbHJdmfrXB- number: H85576470441+ number: H25120892261state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:24.078Z'- updated_at: '2026-03-05T10:13:24.090Z'+ created_at: '2026-03-05T19:35:03.996Z'+ updated_at: '2026-03-05T19:35:04.007Z'shipping_method:id: shpm_gbHJdmfrXBname: UPS Ground@@ -4529,7 +4586,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_188- name: Grayce Green+ name: Marisha O'Reillyaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4654,10 +4711,15 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R208602275+ number: R625291768state: payment- token: NZRpJcNx44om5oCpjk76gse5mB6AMUrqKm4- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: yJAMyEvDaAMDGzhYyubN3Wze5CKJxk35SNM+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4682,16 +4744,16 @@ paths:total: '29.99'display_total: "$29.99"completed_at:- created_at: '2026-03-05T10:13:25.493Z'- updated_at: '2026-03-05T10:13:25.652Z'+ created_at: '2026-03-05T19:35:05.328Z'+ updated_at: '2026-03-05T19:35:05.475Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 442561- slug: product-442561+ name: Product 448391+ slug: product-448391options_text: ''price: '19.99'display_price: "$19.99"@@ -4710,23 +4772,23 @@ paths:discounted_amount: '19.99'display_discounted_amount: "$19.99"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:25.523Z'- updated_at: '2026-03-05T10:13:25.588Z'+ created_at: '2026-03-05T19:35:05.356Z'+ updated_at: '2026-03-05T19:35:05.413Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_EfhxLZ9ck8- number: H12198036611+ number: H64219554110state: pendingtracking:tracking_url:cost: '10.0'display_cost: "$10.00"shipped_at:- created_at: '2026-03-05T10:13:25.608Z'- updated_at: '2026-03-05T10:13:25.623Z'+ created_at: '2026-03-05T19:35:05.432Z'+ updated_at: '2026-03-05T19:35:05.445Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -4734,7 +4796,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_198- name: Sudie Kassulke+ name: Rudy Sengeraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4858,10 +4920,15 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R220845492+ number: R989711655state: complete- token: mkDSifyLJoXLS2BpW3TzPUdBXJXkE3mQDah- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: zDJat8Xk4PMaSdZQW8RZKequC7ztmq4ipTd+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4885,17 +4952,17 @@ paths:display_additional_tax_total: "$0.00"total: '29.99'display_total: "$29.99"- completed_at: '2026-03-05T10:13:26.521Z'- created_at: '2026-03-05T10:13:26.299Z'- updated_at: '2026-03-05T10:13:26.521Z'+ completed_at: '2026-03-05T19:35:06.366Z'+ created_at: '2026-03-05T19:35:06.112Z'+ updated_at: '2026-03-05T19:35:06.366Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 466061- slug: product-466061+ name: Product 467503+ slug: product-467503options_text: ''price: '19.99'display_price: "$19.99"@@ -4914,23 +4981,23 @@ paths:discounted_amount: '19.99'display_discounted_amount: "$19.99"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:26.336Z'- updated_at: '2026-03-05T10:13:26.393Z'+ created_at: '2026-03-05T19:35:06.161Z'+ updated_at: '2026-03-05T19:35:06.241Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_EfhxLZ9ck8- number: H39163777758+ number: H55487054549state: pendingtracking:tracking_url:cost: '10.0'display_cost: "$10.00"shipped_at:- created_at: '2026-03-05T10:13:26.414Z'- updated_at: '2026-03-05T10:13:26.510Z'+ created_at: '2026-03-05T19:35:06.264Z'+ updated_at: '2026-03-05T19:35:06.356Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -4938,7 +5005,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_204- name: Booker Wyman+ name: Lavonia Hoppeaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -4971,11 +5038,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PNHXIEFN+ number: PH6XN3I2amount: '29.99'display_amount: "$29.99"- created_at: '2026-03-05T10:13:26.477Z'- updated_at: '2026-03-05T10:13:26.477Z'+ created_at: '2026-03-05T19:35:06.328Z'+ updated_at: '2026-03-05T19:35:06.328Z'source_type: credit_cardsource_id: card_UkLWZg9DAJsource:@@ -5208,13 +5275,13 @@ paths:id: ps_gbHJdmfrXBstatus: pendingcurrency: USD- external_id: bogus_805547682e999cd75581a08d+ external_id: bogus_e33048fec691d8a43ce399d1external_data:- client_secret: bogus_secret_0b63b5be432cd47b+ client_secret: bogus_secret_4bb4044d1d6130d9customer_external_id:expires_at:- created_at: '2026-03-05T10:13:29.167Z'- updated_at: '2026-03-05T10:13:29.167Z'+ created_at: '2026-03-05T19:35:08.868Z'+ updated_at: '2026-03-05T19:35:08.868Z'amount: '110.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -5319,13 +5386,13 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_65e274969537e434465195c4+ external_id: bogus_cfcf9456dd0fcf0a03c25b0cexternal_data:client_secret: secret_123customer_external_id:expires_at:- created_at: '2026-03-05T10:13:30.421Z'- updated_at: '2026-03-05T10:13:30.421Z'+ created_at: '2026-03-05T19:35:10.152Z'+ updated_at: '2026-03-05T19:35:10.152Z'amount: '110.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -5382,13 +5449,13 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_5b8b6b69b676b612c3cecdfe+ external_id: bogus_58166e989d1599d09a5dd019external_data:client_secret: secret_123customer_external_id:expires_at:- created_at: '2026-03-05T10:13:31.697Z'- updated_at: '2026-03-05T10:13:31.713Z'+ created_at: '2026-03-05T19:35:11.450Z'+ updated_at: '2026-03-05T19:35:11.466Z'amount: '50.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -5486,13 +5553,13 @@ paths:id: ps_UkLWZg9DAJstatus: completedcurrency: USD- external_id: bogus_502f06a49c907d6bbc0dcf73+ external_id: bogus_d8d689f3af2489fd072fc024external_data:client_secret: secret_123customer_external_id:expires_at:- created_at: '2026-03-05T10:13:32.348Z'- updated_at: '2026-03-05T10:13:32.362Z'+ created_at: '2026-03-05T19:35:12.122Z'+ updated_at: '2026-03-05T19:35:12.137Z'amount: '110.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -5572,11 +5639,11 @@ paths:example:id: pss_gbHJdmfrXBstatus: pending- external_id: bogus_seti_29be88e7f2812d817d489dfc- external_client_secret: bogus_seti_secret_e8844b83ad99db1c+ external_id: bogus_seti_3f6527e24ac88aaa9ebaf4ee+ external_client_secret: bogus_seti_secret_b44fd04ca9b2f3f7external_data: {}- created_at: '2026-03-05T10:13:33.634Z'- updated_at: '2026-03-05T10:13:33.634Z'+ created_at: '2026-03-05T19:35:13.408Z'+ updated_at: '2026-03-05T19:35:13.408Z'payment_method_id: pm_UkLWZg9DAJpayment_source_id:payment_source_type:@@ -5673,12 +5740,12 @@ paths:example:id: pss_UkLWZg9DAJstatus: pending- external_id: seti_test_076fc26387e6652e157da4ac- external_client_secret: seti_secret_e1324736e83e1a4b95e713b0+ external_id: seti_test_c065c0b5df30cfa99ce9c81e+ external_client_secret: seti_secret_5b83c1a6cf8cabc0173c87d2external_data:client_secret: secret_123- created_at: '2026-03-05T10:13:35.326Z'- updated_at: '2026-03-05T10:13:35.326Z'+ created_at: '2026-03-05T19:35:15.113Z'+ updated_at: '2026-03-05T19:35:15.113Z'payment_method_id: pm_UkLWZg9DAJpayment_source_id:payment_source_type:@@ -5751,12 +5818,12 @@ paths:example:id: pss_UkLWZg9DAJstatus: completed- external_id: seti_test_7fba894ce8b3e222e32f3b41- external_client_secret: seti_secret_6ec0a4115026e56c3286af57+ external_id: seti_test_bd348254083cc194c30d73d0+ external_client_secret: seti_secret_e78523730c6dca96a6f5cf79external_data:client_secret: secret_123- created_at: '2026-03-05T10:13:36.443Z'- updated_at: '2026-03-05T10:13:36.459Z'+ created_at: '2026-03-05T19:35:16.303Z'+ updated_at: '2026-03-05T19:35:16.318Z'payment_method_id: pm_UkLWZg9DAJpayment_source_id: card_UkLWZg9DAJpayment_source_type: Spree::CreditCard@@ -5839,11 +5906,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PEU8IPGP+ number: PSMKMW11amount: '110.0'display_amount: "$110.00"- created_at: '2026-03-05T10:13:37.707Z'- updated_at: '2026-03-05T10:13:37.707Z'+ created_at: '2026-03-05T19:35:17.630Z'+ updated_at: '2026-03-05T19:35:17.630Z'source_type: credit_cardsource_id: card_UkLWZg9DAJsource:@@ -5937,11 +6004,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PLS89YIA+ number: PQKCJB6Tamount: '110.0'display_amount: "$110.00"- created_at: '2026-03-05T10:13:39.019Z'- updated_at: '2026-03-05T10:13:39.019Z'+ created_at: '2026-03-05T19:35:18.921Z'+ updated_at: '2026-03-05T19:35:18.921Z'source_type: credit_cardsource_id: card_UkLWZg9DAJsource:@@ -6078,20 +6145,17 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 63183- description: |-- Consequatur officiis magnam sequi beatae velit esse. Molestiae similique repellat incidunt alias consequuntur assumenda illum dolore. Dolorum in facere laudantium accusamus cupiditate placeat saepe recusandae.- Iste quidem eveniet facilis temporibus optio illum libero modi. Voluptatibus odit nemo temporibus dolorum quod facilis veritatis. Sunt ea nostrum repellat culpa quos molestias dolores quasi. Numquam veritatis laboriosam earum nostrum voluptatibus non incidunt.- Earum deleniti tenetur consectetur neque consequatur doloribus distinctio. Doloribus atque quae eveniet enim quod. Pariatur nulla veritatis quasi debitis laborum totam et. Iste delectus provident consectetur veritatis minus facere rerum asperiores. Aperiam minus molestiae voluptate ullam voluptates perferendis reiciendis nihil.- Iure aliquid mollitia itaque optio facere temporibus. Repellat dolorem fugit ab veritatis id quibusdam. Dicta et cumque corporis aperiam alias id porro nam. Amet ex reprehenderit cumque fuga recusandae voluptates sed. Suscipit vel iure voluptatum aliquid minus.- Enim dolores ratione praesentium veniam nostrum. Ut repudiandae officiis voluptatem sapiente aperiam. Odit explicabo quis et illum nulla sit. In earum nisi iusto exercitationem praesentium nobis minus.- slug: product-63183+ name: Product 634595+ description: Esse repellat consequatur saepe similique corporis.+ Vero quos repellendus esse impedit cum beatae dolore nam. Veritatis+ eaque dolores atque reprehenderit porro sint adipisci.+ slug: product-634595meta_description:meta_keywords:variant_count: 1- available_on: '2025-03-05T10:13:39.726Z'- created_at: '2026-03-05T10:13:39.744Z'- updated_at: '2026-03-05T10:13:39.801Z'+ available_on: '2025-03-05T19:35:19.615Z'+ created_at: '2026-03-05T19:35:19.634Z'+ updated_at: '2026-03-05T19:35:19.687Z'purchasable: truein_stock: falsebackorderable: true@@ -6111,17 +6175,18 @@ paths:price_list_id:original_price:- id: prod_gbHJdmfrXB- name: Product 644845- description: Pariatur iste culpa quo quaerat dolorum optio. Nobis- possimus laborum autem praesentium cupiditate labore voluptatibus- sunt. Magni temporibus enim qui in.- slug: product-644845+ name: Product 646744+ description: |-+ Veritatis sapiente natus cum alias laboriosam quos. Tempore possimus rem nostrum placeat culpa temporibus libero magni. Quae blanditiis aut itaque accusamus culpa. Autem incidunt nihil hic nemo.+ Libero doloremque odit atque cupiditate temporibus molestiae architecto eum. Quos quidem maxime ex qui distinctio. Aperiam officia voluptates distinctio dolor veniam exercitationem asperiores. Quisquam laboriosam quas velit incidunt consectetur aliquam ex. Dolore culpa nam numquam magnam qui autem voluptatibus ipsum.+ Magnam cumque cum occaecati praesentium. Cumque dolorem quae maiores aspernatur deserunt eveniet voluptate inventore. Nobis laboriosam quos natus facilis officiis cum aut. Vitae blanditiis dolore ad reprehenderit quibusdam mollitia quis. Dolores et sequi molestias qui blanditiis.+ slug: product-646744meta_description:meta_keywords:variant_count: 0- available_on: '2025-03-05T10:13:39.807Z'- created_at: '2026-03-05T10:13:39.820Z'- updated_at: '2026-03-05T10:13:39.835Z'+ available_on: '2025-03-05T19:35:19.702Z'+ created_at: '2026-03-05T19:35:19.714Z'+ updated_at: '2026-03-05T19:35:19.731Z'purchasable: truein_stock: falsebackorderable: true@@ -6220,18 +6285,18 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 753365+ name: Product 75189description: |-- Sunt voluptatum culpa quas sed veritatis. Maxime laborum impedit quasi atque. Laborum sit dolores labore unde aliquid mollitia laboriosam. A provident autem at culpa. Libero sit quae fugit vitae.- Aut voluptatum assumenda occaecati quia ipsum architecto consequuntur. Nihil quod assumenda doloribus molestiae dolorum. Saepe porro vel quaerat ipsa quo. Inventore occaecati natus accusamus accusantium quo fugiat.- Quas possimus fuga iure dolorum aut cupiditate exercitationem nisi. Dolores unde consequatur fugit aperiam dignissimos. Laudantium rerum ipsam debitis culpa aliquid minima.- slug: product-753365+ Amet laboriosam reprehenderit est ut iusto tempore illum. Deserunt molestiae alias aspernatur eligendi est accusantium. Odit totam dolores provident exercitationem. Nam voluptas architecto voluptatibus necessitatibus harum ducimus. Qui debitis distinctio illo fuga praesentium omnis.+ Amet ipsum recusandae distinctio tenetur dolorum ex ipsam. Dolore necessitatibus fuga eaque quibusdam. Ad excepturi molestias sit placeat delectus tenetur.+ Fuga beatae quos debitis provident molestiae. Eveniet impedit ut facere architecto. Corporis quibusdam id similique mollitia ipsa fugiat aperiam cumque. Asperiores ratione praesentium quis iure corporis debitis.+ slug: product-75189meta_description:meta_keywords:variant_count: 1- available_on: '2025-03-05T10:13:40.798Z'- created_at: '2026-03-05T10:13:40.840Z'- updated_at: '2026-03-05T10:13:40.915Z'+ available_on: '2025-03-05T19:35:20.550Z'+ created_at: '2026-03-05T19:35:20.571Z'+ updated_at: '2026-03-05T19:35:20.618Z'purchasable: truein_stock: falsebackorderable: true@@ -6448,15 +6513,15 @@ paths:example:data:- id: ship_UkLWZg9DAJ- number: H99763907331+ number: H35146875600state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:43.668Z'- updated_at: '2026-03-05T10:13:43.684Z'+ created_at: '2026-03-05T19:35:23.282Z'+ updated_at: '2026-03-05T19:35:23.297Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -6464,7 +6529,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_290- name: Mechelle Muller+ name: Amelia Mayertaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6561,15 +6626,15 @@ paths:application/json:example:id: ship_UkLWZg9DAJ- number: H66430609348+ number: H18565636390state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:45.022Z'- updated_at: '2026-03-05T10:13:45.038Z'+ created_at: '2026-03-05T19:35:24.570Z'+ updated_at: '2026-03-05T19:35:24.585Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -6577,7 +6642,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_298- name: Sherell Ebert+ name: Candida Reingeraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6666,10 +6731,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R130981873+ number: R975563241state: delivery- token: dmgW9Kkr3ADhwpYaP99X5Pv23fZProyS8eE- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: CJbm6rkYdJWdTVRMopGtyJtbdFmBD7DSa2B+ email: [email protected]special_instructions:currency: USDlocale: en@@ -6694,16 +6764,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:46.236Z'- updated_at: '2026-03-05T10:13:46.318Z'+ created_at: '2026-03-05T19:35:25.899Z'+ updated_at: '2026-03-05T19:35:25.981Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1077889- slug: product-1077889+ name: Product 1078604+ slug: product-1078604options_text: ''price: '10.0'display_price: "$10.00"@@ -6722,23 +6792,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:46.271Z'- updated_at: '2026-03-05T10:13:46.271Z'+ created_at: '2026-03-05T19:35:25.936Z'+ updated_at: '2026-03-05T19:35:25.936Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H63529024761+ number: H04841465046state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:46.276Z'- updated_at: '2026-03-05T10:13:46.317Z'+ created_at: '2026-03-05T19:35:25.942Z'+ updated_at: '2026-03-05T19:35:25.979Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -6746,7 +6816,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_306- name: Annamarie Stamm+ name: Diane Kozeyaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6882,10 +6952,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R311775774+ number: R027138496state: cart- token: 8tbpJXcEWeXFg4RuxfyEa93vMPuAB42zyPf- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: NPyEiYXrLLfcT76bY6aeMLDToxLubZC71so+ email: [email protected]special_instructions:currency: USDlocale: en@@ -6910,16 +6985,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:47.547Z'- updated_at: '2026-03-05T10:13:47.616Z'+ created_at: '2026-03-05T19:35:27.181Z'+ updated_at: '2026-03-05T19:35:27.238Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 109916- slug: product-109916+ name: Product 1093310+ slug: product-1093310options_text: ''price: '10.0'display_price: "$10.00"@@ -6938,23 +7013,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:47.589Z'- updated_at: '2026-03-05T10:13:47.589Z'+ created_at: '2026-03-05T19:35:27.215Z'+ updated_at: '2026-03-05T19:35:27.215Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H79276526862+ number: H15680061140state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:47.596Z'- updated_at: '2026-03-05T10:13:47.613Z'+ created_at: '2026-03-05T19:35:27.220Z'+ updated_at: '2026-03-05T19:35:27.236Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -6962,7 +7037,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_314- name: Patti Rice+ name: Betsey Metzaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -6984,12 +7059,12 @@ paths:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJstate: checkout- response_code: 1-SC-20260305101347940643- number: PB31NPM5+ response_code: 1-SC-20260305193527550146+ number: PEQTEZ43amount: '10.0'display_amount: "$10.00"- created_at: '2026-03-05T10:13:47.945Z'- updated_at: '2026-03-05T10:13:47.945Z'+ created_at: '2026-03-05T19:35:27.553Z'+ updated_at: '2026-03-05T19:35:27.553Z'source_type: store_creditsource_id: credit_UkLWZg9DAJsource:@@ -7119,10 +7194,15 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R291466717+ number: R408996788state: cart- token: Ujg2thaKHpVPLBNERosPBLAyTshKx47KL8p- email: [email protected]+ checkout_steps:+ - address+ - delivery+ - payment+ - complete+ token: jVpxcp9j8io6mvFXj23CstonrqjaZ4QSrKD+ email: [email protected]special_instructions:currency: USDlocale: en@@ -7147,16 +7227,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-03-05T10:13:49.173Z'- updated_at: '2026-03-05T10:13:49.231Z'+ created_at: '2026-03-05T19:35:28.779Z'+ updated_at: '2026-03-05T19:35:28.835Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1118228- slug: product-1118228+ name: Product 1115497+ slug: product-1115497options_text: ''price: '10.0'display_price: "$10.00"@@ -7175,23 +7255,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-03-05T10:13:49.208Z'- updated_at: '2026-03-05T10:13:49.208Z'+ created_at: '2026-03-05T19:35:28.812Z'+ updated_at: '2026-03-05T19:35:28.812Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H36527459684+ number: H73241956459state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-03-05T10:13:49.213Z'- updated_at: '2026-03-05T10:13:49.228Z'+ created_at: '2026-03-05T19:35:28.818Z'+ updated_at: '2026-03-05T19:35:28.832Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -7199,7 +7279,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_322- name: Emily Crona+ name: Amado Kutchaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -7311,32 +7391,32 @@ paths:- id: txnmy_UkLWZg9DAJname: Categoriesposition: 1- created_at: '2026-03-05T10:12:43.448Z'- updated_at: '2026-03-05T10:12:43.468Z'+ created_at: '2026-03-05T19:34:21.741Z'+ updated_at: '2026-03-05T19:34:21.766Z'root_id: txn_UkLWZg9DAJ- id: txnmy_gbHJdmfrXBname: Brandsposition: 2- created_at: '2026-03-05T10:12:43.469Z'- updated_at: '2026-03-05T10:12:43.477Z'+ created_at: '2026-03-05T19:34:21.767Z'+ updated_at: '2026-03-05T19:34:21.778Z'root_id: txn_gbHJdmfrXB- id: txnmy_EfhxLZ9ck8name: Collectionsposition: 3- created_at: '2026-03-05T10:12:43.479Z'- updated_at: '2026-03-05T10:12:43.616Z'+ created_at: '2026-03-05T19:34:21.779Z'+ updated_at: '2026-03-05T19:34:21.846Z'root_id: txn_EfhxLZ9ck8- id: txnmy_VqXmZF31wYname: taxonomy_11position: 4- created_at: '2026-03-05T10:13:49.272Z'- updated_at: '2026-03-05T10:13:49.282Z'+ created_at: '2026-03-05T19:35:28.871Z'+ updated_at: '2026-03-05T19:35:28.880Z'root_id: txn_OIJLhNcSbf- id: txnmy_uw2YK1rnl0name: taxonomy_12position: 5- created_at: '2026-03-05T10:13:49.283Z'- updated_at: '2026-03-05T10:13:49.292Z'+ created_at: '2026-03-05T19:35:28.881Z'+ updated_at: '2026-03-05T19:35:28.890Z'root_id: txn_AXs1igzRC6meta:page: 1@@ -7416,8 +7496,8 @@ paths:id: txnmy_VqXmZF31wYname: taxonomy_17position: 4- created_at: '2026-03-05T10:13:49.558Z'- updated_at: '2026-03-05T10:13:49.569Z'+ created_at: '2026-03-05T19:35:29.145Z'+ updated_at: '2026-03-05T19:35:29.155Z'root_id: txn_OIJLhNcSbfschema:"$ref": "#/components/schemas/StoreTaxonomy"@@ -7493,8 +7573,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-03-05T10:12:43.458Z'- updated_at: '2026-03-05T10:12:43.467Z'+ created_at: '2026-03-05T19:34:21.753Z'+ updated_at: '2026-03-05T19:34:21.764Z'parent_id:taxonomy_id: txnmy_UkLWZg9DAJdescription: ''@@ -7513,8 +7593,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-03-05T10:12:43.471Z'- updated_at: '2026-03-05T10:12:43.476Z'+ created_at: '2026-03-05T19:34:21.771Z'+ updated_at: '2026-03-05T19:34:21.776Z'parent_id:taxonomy_id: txnmy_gbHJdmfrXBdescription: ''@@ -7533,8 +7613,8 @@ paths:meta_description:meta_keywords:children_count: 2- created_at: '2026-03-05T10:12:43.482Z'- updated_at: '2026-03-05T10:12:43.616Z'+ created_at: '2026-03-05T19:34:21.782Z'+ updated_at: '2026-03-05T19:34:21.846Z'parent_id:taxonomy_id: txnmy_EfhxLZ9ck8description: ''@@ -7553,8 +7633,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-03-05T10:12:43.516Z'- updated_at: '2026-03-05T10:12:43.520Z'+ created_at: '2026-03-05T19:34:21.796Z'+ updated_at: '2026-03-05T19:34:21.798Z'parent_id: txn_EfhxLZ9ck8taxonomy_id: txnmy_EfhxLZ9ck8description: ''@@ -7573,8 +7653,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-03-05T10:12:43.550Z'- updated_at: '2026-03-05T10:12:43.554Z'+ created_at: '2026-03-05T19:34:21.810Z'+ updated_at: '2026-03-05T19:34:21.812Z'parent_id: txn_EfhxLZ9ck8taxonomy_id: txnmy_EfhxLZ9ck8description: ''@@ -7593,8 +7673,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-03-05T10:13:49.994Z'- updated_at: '2026-03-05T10:13:50.050Z'+ created_at: '2026-03-05T19:35:29.624Z'+ updated_at: '2026-03-05T19:35:29.672Z'parent_id:taxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7613,8 +7693,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-03-05T10:13:50.004Z'- updated_at: '2026-03-05T10:13:50.050Z'+ created_at: '2026-03-05T19:35:29.632Z'+ updated_at: '2026-03-05T19:35:29.672Z'parent_id: txn_OIJLhNcSbftaxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7633,8 +7713,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-03-05T10:13:50.016Z'- updated_at: '2026-03-05T10:13:50.024Z'+ created_at: '2026-03-05T19:35:29.642Z'+ updated_at: '2026-03-05T19:35:29.648Z'parent_id: txn_AXs1igzRC6taxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7729,8 +7809,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-03-05T10:13:50.654Z'- updated_at: '2026-03-05T10:13:50.698Z'+ created_at: '2026-03-05T19:35:30.222Z'+ updated_at: '2026-03-05T19:35:30.262Z'parent_id: txn_OIJLhNcSbftaxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7851,19 +7931,19 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 1194924- description: Dignissimos assumenda voluptatem maiores dolorem fugiat- aliquid exercitationem cum. In minima a quaerat sapiente dolor.- Consectetur sint placeat nesciunt et temporibus accusamus. Sequi- repellat maiores quod cum repellendus quaerat. Et illo optio enim- atque facilis voluptatum.- slug: product-1194924+ name: Product 1193095+ description: |-+ Enim assumenda incidunt aliquid eaque hic voluptatibus error. Iure suscipit similique consequatur nobis odit. Ipsam labore consectetur laudantium fugit iusto doloremque quos. Quam hic minima odio nobis quas tenetur harum eum.+ Quod asperiores debitis aliquam doloribus. Eligendi occaecati eveniet itaque tempore pariatur voluptates. Consectetur nobis ducimus magnam cupiditate totam fugit. Dolore temporibus odit expedita recusandae rerum.+ Laboriosam dolores aliquam tenetur excepturi sit. Ex cupiditate dolorum in consectetur sint. Quo vel eligendi ratione doloremque temporibus natus. Cum repudiandae odio eligendi incidunt laboriosam minus ad temporibus.+ Eos consequatur impedit reprehenderit animi repellendus quo est. Tenetur tempora pariatur incidunt quis quos. Laboriosam suscipit eius eveniet veritatis aliquid nostrum quidem. Sed natus sequi aliquam incidunt.+ slug: product-1193095meta_description:meta_keywords:variant_count: 0- available_on: '2025-03-05T10:13:51.626Z'- created_at: '2026-03-05T10:13:51.644Z'- updated_at: '2026-03-05T10:13:51.660Z'+ available_on: '2025-03-05T19:35:31.096Z'+ created_at: '2026-03-05T19:35:31.110Z'+ updated_at: '2026-03-05T19:35:31.125Z'purchasable: truein_stock: falsebackorderable: true@@ -7974,9 +8054,9 @@ paths:data:- id: wl_UkLWZg9DAJname: My Wishlist- token: xFbe8r4JW2JmLbnWPbU3nf1Z- created_at: '2026-03-05T10:13:52.806Z'- updated_at: '2026-03-05T10:13:52.806Z'+ token: FKiQQ2QFPXmFZqUASBUCRQ3u+ created_at: '2026-03-05T19:35:32.216Z'+ updated_at: '2026-03-05T19:35:32.216Z'is_default: falseis_private: truemeta:@@ -8052,9 +8132,9 @@ paths:example:id: wl_gbHJdmfrXBname: Birthday Ideas- token: QF1SAfqELzu2zT8FqkEiELNu- created_at: '2026-03-05T10:13:54.065Z'- updated_at: '2026-03-05T10:13:54.065Z'+ token: jsEaFQGuYmEXdsxo13YymUaQ+ created_at: '2026-03-05T19:35:33.454Z'+ updated_at: '2026-03-05T19:35:33.454Z'is_default: falseis_private: trueschema:@@ -8143,9 +8223,9 @@ paths:example:id: wl_UkLWZg9DAJname: My Wishlist- token: bbJc5dyvARbyYt8dEu9i16Ph- created_at: '2026-03-05T10:13:55.203Z'- updated_at: '2026-03-05T10:13:55.203Z'+ token: rsFPPWayHbkswEFi2cUutMzH+ created_at: '2026-03-05T19:35:34.618Z'+ updated_at: '2026-03-05T19:35:34.618Z'is_default: falseis_private: trueschema:@@ -8207,9 +8287,9 @@ paths:example:id: wl_UkLWZg9DAJname: Updated Name- token: ihAc9ZHb5pQVgBZ4RY8AmBrH- created_at: '2026-03-05T10:13:56.407Z'- updated_at: '2026-03-05T10:13:56.459Z'+ token: K1EScQMC7wA7CsFdaRztftQW+ created_at: '2026-03-05T19:35:35.813Z'+ updated_at: '2026-03-05T19:35:35.857Z'is_default: falseis_private: trueschema:@@ -8321,8 +8401,8 @@ paths:variant_id: variant_gbHJdmfrXBwishlist_id: wl_UkLWZg9DAJquantity: 1- created_at: '2026-03-05T10:13:57.718Z'- updated_at: '2026-03-05T10:13:57.718Z'+ created_at: '2026-03-05T19:35:37.071Z'+ updated_at: '2026-03-05T19:35:37.071Z'variant:id: variant_gbHJdmfrXBproduct_id: prod_gbHJdmfrXB@@ -8331,8 +8411,8 @@ paths:options_text: ''track_inventory: trueimage_count: 0- created_at: '2026-03-05T10:13:57.683Z'- updated_at: '2026-03-05T10:13:57.698Z'+ created_at: '2026-03-05T19:35:37.046Z'+ updated_at: '2026-03-05T19:35:37.056Z'thumbnail:purchasable: truein_stock: false@@ -9460,6 +9540,10 @@ components:type: stringstate:type: string+ checkout_steps:+ type: array+ items:+ type: stringtoken:type: stringemail:@@ -9554,6 +9638,7 @@ components:- id- number- state+ - checkout_steps- token- special_instructionsdiff --git a/packages/sdk/.changeset/add-checkout-steps.md b/packages/sdk/.changeset/add-checkout-steps.mdnew file mode 100644index 0000000000..f9deddcfb1--- /dev/null+++ b/packages/sdk/.changeset/add-checkout-steps.md@@ -0,0 +1,5 @@+---+"@spree/sdk": patch+---++Added `checkout_steps` field to `StoreOrder` type. Returns an array of applicable checkout step names for the order (e.g., `["address", "delivery", "payment", "complete"]`). Steps are dynamic per order — digital-only orders may skip `delivery`, free orders may skip `payment`. Use alongside `state` to build dynamic checkout step indicators.diff --git a/packages/sdk/src/types/generated/AdminOrder.ts b/packages/sdk/src/types/generated/AdminOrder.tsindex 475fa5e7c4..de1e153fd7 100644--- a/packages/sdk/src/types/generated/AdminOrder.ts+++ b/packages/sdk/src/types/generated/AdminOrder.ts@@ -1,4 +1,4 @@-// Typelizer digest 265a7e5bcfb0a3a56645e0c9b1bd2e85+// Typelizer digest 82dab0a1ea1e03620ceb27a5e8c62006//// DO NOT MODIFY: This file was automatically generated by Typelizer.import type {StoreOrderPromotion, AdminLineItem, StoreShipment, StorePayment, StoreAddress, StorePaymentMethod, AdminCustomer} from '@/types'@@ -7,6 +7,7 @@ type AdminOrder = {id: string;number: string;state: string;+ checkout_steps: Array<string>;token: string;email: string | null;special_instructions: string | null;diff --git a/packages/sdk/src/types/generated/StoreOrder.ts b/packages/sdk/src/types/generated/StoreOrder.tsindex bd24a58912..f18e3830b0 100644--- a/packages/sdk/src/types/generated/StoreOrder.ts+++ b/packages/sdk/src/types/generated/StoreOrder.ts@@ -1,4 +1,4 @@-// Typelizer digest 3e1ca7667f7704678ee19c2dec9c0a3c+// Typelizer digest 389371f4adda54ae54924984daf1daa1//// DO NOT MODIFY: This file was automatically generated by Typelizer.import type {StoreOrderPromotion, StoreLineItem, StoreShipment, StorePayment, StoreAddress, StorePaymentMethod} from '@/types'@@ -7,6 +7,7 @@ type StoreOrder = {id: string;number: string;state: string;+ checkout_steps: Array<string>;token: string;email: string | null;special_instructions: string | null;diff --git a/packages/sdk/src/types/generated/index.ts b/packages/sdk/src/types/generated/index.tsindex aad5d956b0..0d0e09a96f 100644--- a/packages/sdk/src/types/generated/index.ts+++ b/packages/sdk/src/types/generated/index.ts@@ -1,4 +1,4 @@-// Typelizer digest 38722111a0f5aebd15b5d766b592482e+// Typelizer digest b3d7211c711e3d69cada8b6366120de7//// DO NOT MODIFY: This file was automatically generated by Typelizer.export type { default as StoreAddress } from './StoreAddress'diff --git a/packages/sdk/src/zod/generated/AdminOrder.ts b/packages/sdk/src/zod/generated/AdminOrder.tsindex 317a14bc90..283314f55b 100644--- a/packages/sdk/src/zod/generated/AdminOrder.ts+++ b/packages/sdk/src/zod/generated/AdminOrder.ts@@ -12,6 +12,7 @@ export const AdminOrderSchema: z.ZodObject<any> = z.object({id: z.string(),number: z.string(),state: z.string(),+ checkout_steps: z.array(z.string()),token: z.string(),email: z.string().nullable(),special_instructions: z.string().nullable(),diff --git a/packages/sdk/src/zod/generated/StoreOrder.ts b/packages/sdk/src/zod/generated/StoreOrder.tsindex 83a4960acf..a1cde3bd8f 100644--- a/packages/sdk/src/zod/generated/StoreOrder.ts+++ b/packages/sdk/src/zod/generated/StoreOrder.ts@@ -11,6 +11,7 @@ export const StoreOrderSchema = z.object({id: z.string(),number: z.string(),state: z.string(),+ checkout_steps: z.array(z.string()),token: z.string(),email: z.string().nullable(),special_instructions: z.string().nullable(),diff --git a/spree/api/TODO.md b/spree/api/TODO.mdnew file mode 100644index 0000000000..6e4174ebeb--- /dev/null+++ b/spree/api/TODO.md@@ -0,0 +1,234 @@+---+ Spree Store API & SDK Review — Competitive Analysis++ Executive Summary++ The Spree v3 API and SDK have a solid foundation — prefixed IDs, flat JSON, consistent snake_case, good TypeScript types, and a clean resource-oriented SDK. But there are meaningful+ gaps compared to Stripe (gold standard) and modern ecommerce competitors (Medusa v2, Saleor, Vendure).++ ---+ 1. OpenAPI Spec Quality Issues++ Orphan schemas polluting the spec++ The Store API spec contains 19 orphan schemas that no endpoint references: StoreNewsletterSubscriber, StoreExport, StoreImport, StoreStockItem, StoreReport, StorePromotion, etc. These+ appear to be auto-generated by typelizer but serve no purpose in the Store API. Admin schemas (AdminCustomer, AdminOrder, AdminProduct, etc.) are also leaked into the Store spec,+ exposing sensitive field names like last_sign_in_ip, considered_risky, internal_note.++ Fix: Filter typelizer output to only include schemas referenced by Store API endpoints.++ PaginationMeta schema is incomplete++ The schema defines only 4 fields (page, limit, count, pages), but every response example includes 9 fields (from, to, in, previous, next are undocumented). SDKs and code generators+ will miss these fields.++ Missing "Markets" tag++ 5 market endpoints use the Markets tag, but it's missing from the top-level tags array and x-tagGroups.++ Inconsistent order_token parameter naming++ Some endpoints use order_token, others use token for the same concept (guest order access). This is a real stumbling block for developers.++ Monetary amount type inconsistency++ - StoreShipment.cost → string ("100.0")+ - StoreShippingRate.cost → number (100.0)+ - StoreGiftCard.amount → number+ - StoreOrder.total → string++ Stripe consistently uses integer cents for all amounts. Medusa uses number. Pick one and be consistent.++ StorePayment.source_type enum has empty entry++ enum:+ - credit_card+ - store_credit+ - payment_source+ - # ← null/empty++ ---+ 2. API Design Gaps vs. Stripe++ ┌───────────────────────┬─────────────────────────────────────────────────────┬───────────────────────────────┬─────────────────────────────────────────────────────────────────┐+ │ Feature │ Stripe │ Spree v3 │ Gap │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Pagination │ Cursor-based (starting_after, has_more) │ Offset-based (page, limit) │ Offset breaks with concurrent writes; no auto-pagination in SDK │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Versioning │ Date-based with account pinning (2024-12-18.acacia) │ None (just /v3/) │ Breaking changes will hurt existing integrations │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Idempotency │ Idempotency-Key header, 24h TTL │ None │ Cart operations, payments can create duplicates on retry │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Error doc_url │ Every error links to docs │ Not present │ Developers must search docs manually │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Error request_id │ Every response includes req_abc123 │ Not present │ No way to correlate errors with server logs │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ expand[] depth │ Up to 4 levels deep, dot notation │ Single level, comma-separated │ Can't do expand=line_items.variant.product │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Metadata │ 50 key-value pairs on every resource, searchable │ Only some resources │ Can't attach custom data to orders/products from storefront │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Webhook signing │ HMAC-SHA256 with replay protection │ Not in Store API spec │ Webhook consumers can't verify authenticity │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ SDK auto-pagination │ for await (const item of stripe.products.list()) │ Manual page iteration │ Tedious for large datasets │+ ├───────────────────────┼─────────────────────────────────────────────────────┼───────────────────────────────┼─────────────────────────────────────────────────────────────────┤+ │ Rate limiting headers │ Retry-After, RateLimit-* │ Not documented │ Clients can't implement proper backoff │+ └───────────────────────┴─────────────────────────────────────────────────────┴───────────────────────────────┴─────────────────────────────────────────────────────────────────┘++ ---+ 3. API Design Gaps vs. Ecommerce Competitors++ vs. Medusa v2++ ┌───────────────────────┬──────────────────────────────────────────────────────┬───────────────────────────────────┬───────────────────────────────────────────────────────────────┐+ │ Feature │ Medusa │ Spree │ Gap │+ ├───────────────────────┼──────────────────────────────────────────────────────┼───────────────────────────────────┼───────────────────────────────────────────────────────────────┤+ │ Field selection │ fields=+title,-desc,*variants (additive/subtractive) │ expand=variants (all-or-nothing) │ Spree returns full objects or nothing — over-fetching problem │+ ├───────────────────────┼──────────────────────────────────────────────────────┼───────────────────────────────────┼───────────────────────────────────────────────────────────────┤+ │ Sorting syntax │ order=-created_at (minus = desc) │ sort=price desc (space-separated) │ Medusa's is more standard (many APIs use - prefix) │+ ├───────────────────────┼──────────────────────────────────────────────────────┼───────────────────────────────────┼───────────────────────────────────────────────────────────────┤+ │ Sort on all endpoints │ Yes │ Only product listings │ Can't sort orders, addresses, wishlists │+ ├───────────────────────┼──────────────────────────────────────────────────────┼───────────────────────────────────┼───────────────────────────────────────────────────────────────┤+ │ SDK streaming │ fetchStream() for SSE │ None │ No real-time progress for long operations │+ └───────────────────────┴──────────────────────────────────────────────────────┴───────────────────────────────────┴───────────────────────────────────────────────────────────────┘++ vs. Saleor++ ┌───────────────────────────────┬───────────────────────────────────────────────────┬──────────────────────────┬─────────────────────────────────────────────┐+ │ Feature │ Saleor │ Spree │ Gap │+ ├───────────────────────────────┼───────────────────────────────────────────────────┼──────────────────────────┼─────────────────────────────────────────────┤+ │ JWKS endpoint │ /.well-known/jwks.json for stateless verification │ None │ Can't verify tokens at the edge/CDN │+ ├───────────────────────────────┼───────────────────────────────────────────────────┼──────────────────────────┼─────────────────────────────────────────────┤+ │ Webhook payload customization │ GraphQL subscription syntax defines payload │ Fixed payloads │ Webhook consumers get everything or nothing │+ ├───────────────────────────────┼───────────────────────────────────────────────────┼──────────────────────────┼─────────────────────────────────────────────┤+ │ Modular auth SDK │ Tiny auth-sdk (3kB) handles all auth flows │ Auth baked into full SDK │ Can't use auth separately from the full SDK │+ └───────────────────────────────┴───────────────────────────────────────────────────┴──────────────────────────┴─────────────────────────────────────────────┘++ vs. Vendure++ ┌──────────────────────────┬───────────────────────────────────────────────────────────────┬───────────────────────────┬───────────────────────────────────────────────────────────┐+ │ Feature │ Vendure │ Spree │ Gap │+ ├──────────────────────────┼───────────────────────────────────────────────────────────────┼───────────────────────────┼───────────────────────────────────────────────────────────┤+ │ Typed error results │ Union types: Order | CouponCodeExpiredError | │ Generic error object │ Clients can't exhaustively handle all error cases at │+ │ │ CouponCodeInvalidError │ │ compile time │+ ├──────────────────────────┼───────────────────────────────────────────────────────────────┼───────────────────────────┼───────────────────────────────────────────────────────────┤+ │ Automatic filter │ All entity fields auto-filterable/sortable │ Manually defined per │ Adding a new field doesn't make it filterable │+ │ generation │ │ endpoint │ │+ └──────────────────────────┴───────────────────────────────────────────────────────────────┴───────────────────────────┴───────────────────────────────────────────────────────────┘++ ---+ 4. SDK-Specific Issues++ client.store.store.get() reads terribly++ The double .store.store. is confusing — first is the API scope, second is the resource. Consider aliasing to client.store.info.get() or client.store.storeInfo.get().++ SDK quickstart docs show non-existent methods++ The docs show client.store.orders.list() but this doesn't exist — it's client.store.customer.orders.list(). This will be developers' first frustration.++ publishableKey is required even for Admin-only usage++ The SpreeClientConfig interface marks publishableKey as required. Admin-only consumers must still provide one.++ No request/response interceptors++ No middleware pattern for:+ - Automatic token refresh on 401+ - Request/response logging+ - Analytics+ - Custom error transformation++ Stripe, Medusa, and most modern SDKs support interceptors.++ No auto-pagination++ Stripe:+ for await (const product of stripe.products.list()) { ... }+ Spree: manual page loop with meta.pages check. This is table-stakes DX in 2026.++ Inconsistent list response shapes++ Some lists return PaginatedResponse<T> (with meta), others return bare { data: T[] } (countries, currencies, locales, markets). Consumers can't rely on a uniform shape.++ StoreCountry.market typed as unknown++ No type safety for an important association.++ Admin client is an empty shell++ AdminClient is exported publicly but has zero functionality. This misleads developers who see it in autocomplete.++ ---+ 5. Checkout Flow DX Issues++ No clear state machine documentation++ Vendure's AddingItems → ArrangingPayment → PaymentSettled makes the order lifecycle crystal clear. Spree's next/advance/complete endpoints don't communicate what states exist or what's+ required at each step. The API spec doesn't document the checkout state machine.++ No eligibleShippingMethods equivalent++ Vendure has a dedicated query for "what shipping methods can this order use?" Spree requires listing shipments, then looking at shipping rates — an indirect path.++ Payment Sessions abstraction is good but underdocumented++ The payment session flow (create → update → complete) is a solid abstraction that decouples payment providers, but the OpenAPI spec doesn't explain the flow or when each step is+ needed.++ ---+ 6. Missing Endpoints Compared to Competitors++ ┌────────────────────────────┬────────────────────────┬─────────────────┬─────────────────┬────────────────────────┐+ │ Feature │ Medusa │ Saleor │ Vendure │ Spree │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Product reviews/ratings │ ✓ │ Via apps │ Via plugins │ Missing │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Product search (full-text) │ ✓ (dedicated endpoint) │ ✓ │ ✓ │ Only Ransack name_cont │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Return/refund requests │ ✓ │ ✓ │ ✓ │ Missing from Store API │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Order cancellation │ ✓ │ ✓ │ ✓ │ Missing from Store API │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Notifications/preferences │ ✓ │ ✓ │ Via plugins │ Missing │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Recently viewed │ ✗ │ ✗ │ ✗ │ Missing │+ ├────────────────────────────┼────────────────────────┼─────────────────┼─────────────────┼────────────────────────┤+ │ Collections/curated lists │ ✓ │ ✓ (Collections) │ ✓ (Collections) │ Only via Taxons │+ └────────────────────────────┴────────────────────────┴─────────────────┴─────────────────┴────────────────────────┘++ ---+ 7. Top Priority Recommendations++ Critical (breaks developer trust)++ 1. Fix orphan/admin schemas in Store API spec — leaking AdminCustomer with last_sign_in_ip is a security smell+ 2. Fix PaginationMeta schema — add the 5 missing fields+ 3. Standardize order_token/token parameter naming — pick one+ 4. Fix SDK docs — orders.list() doesn't exist, will be first thing developers try+ 5. Standardize monetary types — all strings or all numbers, document the choice++ High Priority (competitive gap)++ 6. Add request_id to every response — essential for debugging+ 7. Add idempotency key support — at minimum for payment operations+ 8. Add auto-pagination to SDK — for await iterator pattern+ 9. Document the checkout state machine — what states exist, what transitions are valid, what's required at each step+ 10. Add field selection — even basic fields=name,slug,price to reduce payload size (Medusa's +/-/* operators are the gold standard here)++ Medium Priority (DX polish)++ 11. Add doc_url to error responses — link to relevant docs page+ 12. Add rate limiting headers — X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After+ 13. Support nested expand — expand=line_items.variant.product+ 14. Add sort parameter to all list endpoints — not just products+ 15. Add request/response interceptors to SDK+ 16. Rename client.store.store to client.store.storeInfo or similar+ 17. Don't export empty AdminClient — or add a deprecation/coming-soon notice++ Nice to Have (forward-looking)++ 18. API versioning strategy — date-based like Stripe, or at least a migration guide system+ 19. Customer-facing returns/cancellation endpoints+ 20. Full-text search endpoint — beyond Ransack _cont+ 21. JWKS endpoint — for edge/CDN token verification+ 22. Cursor-based pagination option — alongside offset for high-volume endpointsdiff --git a/spree/api/app/serializers/spree/api/v3/order_serializer.rb b/spree/api/app/serializers/spree/api/v3/order_serializer.rbindex 842cb9831b..fd2897284b 100644--- a/spree/api/app/serializers/spree/api/v3/order_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/order_serializer.rb@@ -4,7 +4,7 @@ module Spree# Store API Order Serializer# Customer-facing order dataclass OrderSerializer < BaseSerializer- typelize number: :string, state: :string, token: :string, email: [:string, nullable: true],+ typelize number: :string, state: :string, checkout_steps: 'string[]', token: :string, email: [:string, nullable: true],special_instructions: [:string, nullable: true], currency: :string, locale: [:string, nullable: true], item_count: :number,state_lock_version: :number, shipment_state: [:string, nullable: true], payment_state: [:string, nullable: true],item_total: :string, display_item_total: :string,@@ -17,7 +17,7 @@ module Spreetotal: :string, display_total: :string, completed_at: [:string, nullable: true],bill_address: { nullable: true }, ship_address: { nullable: true }- attributes :number, :state, :token, :email, :special_instructions,+ attributes :number, :state, :checkout_steps, :token, :email, :special_instructions,:currency, :locale, :item_count, :state_lock_version, :shipment_state, :payment_state,:item_total, :display_item_total, :ship_total, :display_ship_total,:adjustment_total, :display_adjustment_total, :promo_total, :display_promo_total,diff --git a/spree/api/spec/integration/spree/api/v3/store/orders_spec.rb b/spree/api/spec/integration/spree/api/v3/store/orders_spec.rbindex ccf2d76805..da8ee024a8 100644--- a/spree/api/spec/integration/spree/api/v3/store/orders_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/orders_spec.rb@@ -42,6 +42,8 @@ RSpec.describe 'Orders API', type: :request, swagger_doc: 'api-reference/store.yrun_test! do |response|data = JSON.parse(response.body)expect(data['number']).to eq(order.number)+ expect(data['checkout_steps']).to be_an(Array)+ expect(data['checkout_steps']).to include('address', 'complete')endend