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
Added ability to persist metadata for Carts/Orders/LineItems in Store… (#13675)
Damian Legawiecdda4fb791f73
diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yamlindex 18d797ae74..8b2ee39fd6 100644--- a/docs/api-reference/store.yaml+++ b/docs/api-reference/store.yaml@@ -640,14 +640,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MjIwODM3MH0.YLtokUuSh_rje6lOhjD2-sHrnEQFYzCzMOqA5Z_lWU4+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6ImY0NDVhN2VmLWVhZDAtNDk2Yi1iODBlLTMwZDM1YWY0OGE1NiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyMTk1MTEzfQ.wj2i1XpLkZJ7xMVdo6tabUDuchbpsIDuIVThzB5qivkuser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Tuan- last_name: Deckow- created_at: '2026-02-26T16:06:09.736Z'- updated_at: '2026-02-26T16:06:09.736Z'+ first_name: Carmelia+ last_name: Watsica+ created_at: '2026-02-27T11:25:13.280Z'+ updated_at: '2026-02-27T11:25:13.280Z'addresses: []default_billing_address:default_shipping_address:@@ -720,14 +720,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MjIwODM3MX0.rNbg7hOKqAXPuGSyqkx_St68urMcafNnSe6oJ8qSR9I+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjlmODc0YWJjLTVjOWQtNDA1YS1iNWZhLTg5Y2VkZWU2NDgwNiIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyMTk1MTE0fQ.tjP8b9UShPhYAINycB95mdWm4PFXVdbB5V93Jw1ITpwuser:id: cus_UkLWZg9DAJemail: [email protected]first_name: Johnlast_name: Doe- created_at: '2026-02-26T16:06:11.154Z'- updated_at: '2026-02-26T16:06:11.154Z'+ created_at: '2026-02-27T11:25:14.689Z'+ updated_at: '2026-02-27T11:25:14.689Z'addresses: []default_billing_address:default_shipping_address:@@ -813,14 +813,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MjIwODM3MX0.rNbg7hOKqAXPuGSyqkx_St68urMcafNnSe6oJ8qSR9I+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImp0aSI6IjE3MWY3YWY1LWYyMDktNDlmYS05NTdmLTg1Y2FmYTgwZmE3YyIsImlzcyI6InNwcmVlIiwiYXVkIjoic3RvcmVfYXBpIiwiZXhwIjoxNzcyMTk1MTE1fQ.EVJN3EqdRpZoUgQ36mPe0MhBROFfssfEaAd4VqFfr10user:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Brigitte- last_name: Murazik- created_at: '2026-02-26T16:06:11.709Z'- updated_at: '2026-02-26T16:06:11.709Z'+ first_name: Marx+ last_name: Bradtke+ created_at: '2026-02-27T11:25:15.259Z'+ updated_at: '2026-02-27T11:25:15.259Z'addresses: []default_billing_address:default_shipping_address:@@ -872,15 +872,15 @@ paths:type: stringresponses:'201':- description: cart created (authenticated)+ description: cart created with metadatacontent:application/json:example:id: or_UkLWZg9DAJ- number: R662213211+ number: R308659188state: cart- token: y4ZWxkrOPzLG4YnvITrMPA1772121972327- email: [email protected]+ token: 5THdvuVJEfbI8Knuk9i8OA1772191515907+ email:special_instructions:currency: USDlocale: en@@ -904,8 +904,8 @@ paths:total: '0.0'display_total: "$0.00"completed_at:- created_at: '2026-02-26T16:06:12.329Z'- updated_at: '2026-02-26T16:06:12.329Z'+ created_at: '2026-02-27T11:25:15.908Z'+ updated_at: '2026-02-27T11:25:15.908Z'order_promotions: []line_items: []shipments: []@@ -925,6 +925,16 @@ paths:message: Valid API key requiredschema:"$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ metadata:+ type: object+ description: Write-only key-value metadata (Stripe-style). Not returned+ in responses.get:summary: Get current carttags:@@ -980,10 +990,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R595550244+ number: R691356136state: cart- token: SzBmh4WrnFsoxcg6CzwTeF8brhdmHSAgobu- email: [email protected]+ token: K8vtpSNhgapAxg3DwA37HZq6Crk9ZeQEnoj+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1007,16 +1017,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:13.406Z'- updated_at: '2026-02-26T16:06:13.475Z'+ created_at: '2026-02-27T11:25:16.991Z'+ updated_at: '2026-02-27T11:25:17.064Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 23028- slug: product-23028+ name: Product 23184+ slug: product-23184options_text: ''price: '10.0'display_price: "$10.00"@@ -1035,23 +1045,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:13.449Z'- updated_at: '2026-02-26T16:06:13.449Z'+ created_at: '2026-02-27T11:25:17.035Z'+ updated_at: '2026-02-27T11:25:17.035Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H44243739611+ number: H56774515281state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:13.455Z'- updated_at: '2026-02-26T16:06:13.473Z'+ created_at: '2026-02-27T11:25:17.043Z'+ updated_at: '2026-02-27T11:25:17.061Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1059,7 +1069,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_41- name: Jeanette Trantow+ name: Luna Blockaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1181,10 +1191,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R623991697+ number: R544962154state: cart- token: VEAkgfRVvfwxGN5amfHXniD2DpPLfPzU1Gj- email: [email protected]+ token: ZGE8eTtvahe8jwMoJWzqVVxgmgvGa66KRgi+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1208,16 +1218,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:13.535Z'- updated_at: '2026-02-26T16:06:13.596Z'+ created_at: '2026-02-27T11:25:17.122Z'+ updated_at: '2026-02-27T11:25:17.191Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 31522- slug: product-31522+ name: Product 39581+ slug: product-39581options_text: ''price: '10.0'display_price: "$10.00"@@ -1236,23 +1246,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:13.572Z'- updated_at: '2026-02-26T16:06:13.572Z'+ created_at: '2026-02-27T11:25:17.163Z'+ updated_at: '2026-02-27T11:25:17.163Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H31166112196+ number: H55953243165state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:13.578Z'- updated_at: '2026-02-26T16:06:13.593Z'+ created_at: '2026-02-27T11:25:17.170Z'+ updated_at: '2026-02-27T11:25:17.188Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1260,7 +1270,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_45- name: Kamilah Frami+ name: Donte Schowalteraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1563,10 +1573,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R618569947+ number: R471285738state: cart- token: qonjHhmXQzce1dZroHiHihQK35eXUN71Ysn- email: [email protected]+ token: icRPmV6D8NJGiJ6N7aN8K97CiYENGQqztdc+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1590,16 +1600,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:18.021Z'- updated_at: '2026-02-26T16:06:18.149Z'+ created_at: '2026-02-27T11:25:21.422Z'+ updated_at: '2026-02-27T11:25:21.528Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 82474- slug: product-82474+ name: Product 87801+ slug: product-87801options_text: ''price: '10.0'display_price: "$10.00"@@ -1618,23 +1628,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:18.058Z'- updated_at: '2026-02-26T16:06:18.058Z'+ created_at: '2026-02-27T11:25:21.455Z'+ updated_at: '2026-02-27T11:25:21.455Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H03085198747+ number: H17816607735state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:18.064Z'- updated_at: '2026-02-26T16:06:18.081Z'+ created_at: '2026-02-27T11:25:21.461Z'+ updated_at: '2026-02-27T11:25:21.476Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1642,7 +1652,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_65- name: Tawnya Haley+ name: Sarah Howelladdress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -1664,12 +1674,12 @@ paths:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJstate: checkout- response_code: 1-SC-20260226160618143531- number: PBCWWV3L+ response_code: 1-SC-20260227112521523745+ number: PBMFSLQKamount: '50.0'display_amount: "$50.00"- created_at: '2026-02-26T16:06:18.148Z'- updated_at: '2026-02-26T16:06:18.148Z'+ created_at: '2026-02-27T11:25:21.528Z'+ updated_at: '2026-02-27T11:25:21.528Z'source_type: store_creditsource_id: credit_UkLWZg9DAJsource:@@ -1819,10 +1829,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R990925008+ number: R362008552state: cart- token: iz82uiX3ckDTKsWFnokTjUhzCMY7iBYeeC1- email: [email protected]+ token: o2gCwCeUG1jWL37gAVQBVjNN1VyimFVRYjZ+ email: [email protected]special_instructions:currency: USDlocale: en@@ -1846,16 +1856,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:19.981Z'- updated_at: '2026-02-26T16:06:20.097Z'+ created_at: '2026-02-27T11:25:23.401Z'+ updated_at: '2026-02-27T11:25:23.529Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 113024- slug: product-113024+ name: Product 115913+ slug: product-115913options_text: ''price: '10.0'display_price: "$10.00"@@ -1874,23 +1884,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:20.010Z'- updated_at: '2026-02-26T16:06:20.091Z'+ created_at: '2026-02-27T11:25:23.434Z'+ updated_at: '2026-02-27T11:25:23.521Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H38489500513+ number: H43445641244state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:20.017Z'- updated_at: '2026-02-26T16:06:20.034Z'+ created_at: '2026-02-27T11:25:23.439Z'+ updated_at: '2026-02-27T11:25:23.464Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -1898,7 +1908,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_77- name: Serafina Jones+ name: Yee Thompsonaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2291,10 +2301,10 @@ paths:example:data:- id: or_UkLWZg9DAJ- number: R242827422+ number: R417889326state: cart- token: rZZsqmHdZzSDzoeiL8qbmGGz4CKveu2gf3K- email: [email protected]+ token: MiA5TiQPSAW5qJT2EKFvCfp2qaJ6oootxUj+ email: [email protected]special_instructions:currency: USDlocale: en@@ -2318,16 +2328,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:24.850Z'- updated_at: '2026-02-26T16:06:24.911Z'+ created_at: '2026-02-27T11:25:28.305Z'+ updated_at: '2026-02-27T11:25:28.379Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 135006- slug: product-135006+ name: Product 132130+ slug: product-132130options_text: ''price: '10.0'display_price: "$10.00"@@ -2346,23 +2356,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:24.886Z'- updated_at: '2026-02-26T16:06:24.886Z'+ created_at: '2026-02-27T11:25:28.354Z'+ updated_at: '2026-02-27T11:25:28.354Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H90020135968+ number: H59764761115state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:24.892Z'- updated_at: '2026-02-26T16:06:24.909Z'+ created_at: '2026-02-27T11:25:28.361Z'+ updated_at: '2026-02-27T11:25:28.376Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Ground@@ -2370,7 +2380,7 @@ paths:stock_location:id: sloc_UkLWZg9DAJstate_abbr: STATE_ABBR_100- name: Naoma Renner+ name: Yang Purdyaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'@@ -2493,11 +2503,11 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Nobuko- last_name: Gutkowski- created_at: '2026-02-26T16:06:25.896Z'- updated_at: '2026-02-26T16:06:26.171Z'+ email: [email protected]+ first_name: Cordia+ last_name: Denesik+ created_at: '2026-02-27T11:25:29.497Z'+ updated_at: '2026-02-27T11:25:29.852Z'addresses:- id: addr_gbHJdmfrXBfirstname: John@@ -2616,11 +2626,11 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Updatedlast_name: Name- created_at: '2026-02-26T16:06:26.471Z'- updated_at: '2026-02-26T16:06:26.755Z'+ created_at: '2026-02-27T11:25:30.182Z'+ updated_at: '2026-02-27T11:25:30.485Z'addresses:- id: addr_gbHJdmfrXBfirstname: John@@ -2829,7 +2839,7 @@ paths:example:data:- id: gc_UkLWZg9DAJ- code: 2AAC52F0F6BB6F94+ code: 56F046EC63F0D926state: activecurrency: USDamount: 10.0@@ -2843,8 +2853,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-02-26T16:06:29.964Z'- updated_at: '2026-02-26T16:06:29.964Z'+ created_at: '2026-02-27T11:25:34.050Z'+ updated_at: '2026-02-27T11:25:34.050Z'meta:page: 1limit: 25@@ -2920,7 +2930,7 @@ paths:application/json:example:id: gc_UkLWZg9DAJ- code: 0DE812863F92BC97+ code: 7F3C50C07D50225Estate: activecurrency: USDamount: 10.0@@ -2934,8 +2944,8 @@ paths:redeemed_at:expired: falseactive: true- created_at: '2026-02-26T16:06:31.064Z'- updated_at: '2026-02-26T16:06:31.064Z'+ created_at: '2026-02-27T11:25:35.204Z'+ updated_at: '2026-02-27T11:25:35.204Z'schema:"$ref": "#/components/schemas/StoreGiftCard"'404':@@ -3001,23 +3011,23 @@ paths:type: stringresponses:'201':- description: item added, returns updated order+ description: item added with metadatacontent:application/json:example:id: or_UkLWZg9DAJ- number: R597448967+ number: R496676516state: cart- token: YW1p6zL8VQkY3kxsmxrxH9e9bkgRHiiHgHL- email: [email protected]+ token: m97kWiKXB8TaMYRUi43NzqZVfd4GMtLUWfJ+ email: [email protected]special_instructions:currency: USDlocale: en- item_count: 3+ item_count: 2shipment_state:payment_state:- item_total: '49.98'- display_item_total: "$49.98"+ item_total: '29.99'+ display_item_total: "$29.99"ship_total: '0.0'display_ship_total: "$0.00"adjustment_total: '0.0'@@ -3030,19 +3040,19 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '49.98'- display_total: "$49.98"+ total: '29.99'+ display_total: "$29.99"completed_at:- created_at: '2026-02-26T16:06:32.180Z'- updated_at: '2026-02-26T16:06:32.270Z'+ created_at: '2026-02-27T11:25:37.052Z'+ updated_at: '2026-02-27T11:25:37.138Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 219775- slug: product-219775+ name: Product 238769+ slug: product-238769options_text: ''price: '10.0'display_price: "$10.00"@@ -3061,23 +3071,23 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:32.219Z'- updated_at: '2026-02-26T16:06:32.219Z'+ created_at: '2026-02-27T11:25:37.089Z'+ updated_at: '2026-02-27T11:25:37.089Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXB- quantity: 2+ quantity: 1currency: USD- name: Product 222849- slug: product-222849+ name: Product 249234+ slug: product-249234options_text: ''price: '19.99'display_price: "$19.99"- total: '39.98'- display_total: "$39.98"+ total: '19.99'+ display_total: "$19.99"adjustment_total: '0.0'display_adjustment_total: "$0.00"additional_tax_total: '0.0'@@ -3086,13 +3096,13 @@ paths:display_included_tax_total: "$0.00"promo_total: '0.0'display_promo_total: "$0.00"- pre_tax_amount: '39.98'- display_pre_tax_amount: "$39.98"- discounted_amount: '39.98'- display_discounted_amount: "$39.98"+ pre_tax_amount: '19.99'+ display_pre_tax_amount: "$19.99"+ discounted_amount: '19.99'+ display_discounted_amount: "$19.99"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:32.269Z'- updated_at: '2026-02-26T16:06:32.269Z'+ created_at: '2026-02-27T11:25:37.138Z'+ updated_at: '2026-02-27T11:25:37.138Z'compare_at_amount:thumbnail_url:option_values: []@@ -3104,7 +3114,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 133 Lovely Street+ address1: 136 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3112,9 +3122,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_133- state_abbr: STATE_ABBR_133- state_name: STATE_NAME_133+ state_text: STATE_ABBR_136+ state_abbr: STATE_ABBR_136+ state_name: STATE_NAME_136ship_address:payment_methods: []schema:@@ -3143,6 +3153,13 @@ paths:type: integerexample: 2description: 'Quantity to add (default: 1)'+ metadata:+ type: object+ additionalProperties: true+ description: Arbitrary key-value metadata (stored, not returned+ in responses)+ example:+ gift_message: Happy Birthday!required:- variant_id"/api/v3/store/orders/{order_id}/line_items/{id}":@@ -3199,23 +3216,23 @@ paths:type: stringresponses:'200':- description: quantity updated, returns updated order+ description: metadata updated on line itemcontent:application/json:example:id: or_UkLWZg9DAJ- number: R878872326+ number: R128128156state: cart- token: scnnzKhFbbvqXTiCAAd8tyvsXPhsDPaiDFd- email: [email protected]+ token: EfdCycm8VeMsvhDsfRo9rhNotgB1TLjpdqh+ email: [email protected]special_instructions:currency: USDlocale: en- item_count: 5+ item_count: 0shipment_state:payment_state:- item_total: '99.95'- display_item_total: "$99.95"+ item_total: '0.0'+ display_item_total: "$0.00"ship_total: '0.0'display_ship_total: "$0.00"adjustment_total: '0.0'@@ -3228,24 +3245,24 @@ paths:display_included_tax_total: "$0.00"additional_tax_total: '0.0'display_additional_tax_total: "$0.00"- total: '99.95'- display_total: "$99.95"+ total: '0.0'+ display_total: "$0.00"completed_at:- created_at: '2026-02-26T16:06:34.343Z'- updated_at: '2026-02-26T16:06:34.441Z'+ created_at: '2026-02-27T11:25:39.567Z'+ updated_at: '2026-02-27T11:25:39.620Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJ- quantity: 5+ quantity: 1currency: USD- name: Product 255494- slug: product-255494+ name: Product 287972+ slug: product-287972options_text: ''- price: '19.99'- display_price: "$19.99"- total: '99.95'- display_total: "$99.95"+ price: '10.0'+ display_price: "$10.00"+ total: '10.0'+ display_total: "$10.00"adjustment_total: '0.0'display_adjustment_total: "$0.00"additional_tax_total: '0.0'@@ -3254,13 +3271,13 @@ paths:display_included_tax_total: "$0.00"promo_total: '0.0'display_promo_total: "$0.00"- pre_tax_amount: '99.95'- display_pre_tax_amount: "$99.95"- discounted_amount: '99.95'- display_discounted_amount: "$99.95"+ pre_tax_amount: '10.0'+ display_pre_tax_amount: "$10.00"+ discounted_amount: '10.0'+ display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:34.402Z'- updated_at: '2026-02-26T16:06:34.453Z'+ created_at: '2026-02-27T11:25:39.603Z'+ updated_at: '2026-02-27T11:25:39.619Z'compare_at_amount:thumbnail_url:option_values: []@@ -3272,7 +3289,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 142 Lovely Street+ address1: 148 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3280,9 +3297,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_142- state_abbr: STATE_ABBR_142- state_name: STATE_NAME_142+ state_text: STATE_ABBR_148+ state_abbr: STATE_ABBR_148+ state_name: STATE_NAME_148ship_address:payment_methods: []schema:@@ -3297,8 +3314,12 @@ paths:type: integerminimum: 1example: 5- required:- - quantity+ metadata:+ type: object+ additionalProperties: true+ description: Arbitrary key-value metadata (merged with existing)+ example:+ engraving: J.D.delete:summary: Remove line item from carttags:@@ -3354,10 +3375,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R607747365+ number: R502423158state: cart- token: LfZh7JBDTFdufLQbGsdjhaVS3wFb69ewyYv- email: [email protected]+ token: HxvBbPzVt1wNiQJ8ADaw9mr9eZt5azm3rJi+ email: [email protected]special_instructions:currency: USDlocale: en@@ -3381,8 +3402,8 @@ paths:total: '0.0'display_total: "$0.00"completed_at:- created_at: '2026-02-26T16:06:35.093Z'- updated_at: '2026-02-26T16:06:35.215Z'+ created_at: '2026-02-27T11:25:40.193Z'+ updated_at: '2026-02-27T11:25:40.252Z'order_promotions: []line_items: []shipments: []@@ -3392,7 +3413,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 145 Lovely Street+ address1: 151 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3400,9 +3421,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_145- state_abbr: STATE_ABBR_145- state_name: STATE_NAME_145+ state_text: STATE_ABBR_151+ state_abbr: STATE_ABBR_151+ state_name: STATE_NAME_151ship_address:payment_methods: []schema:@@ -3534,9 +3555,9 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R510961949+ number: R159110306state: cart- token: sXxjRt6Dd7wEdkbBmPXfcrQbegPnc3U6aYj+ token: 6fuRmHSes429qP4cWsZZTrkSxyT6Qpd1kWPemail:special_instructions:currency: USD@@ -3561,16 +3582,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:37.325Z'- updated_at: '2026-02-26T16:06:37.378Z'+ created_at: '2026-02-27T11:25:42.471Z'+ updated_at: '2026-02-27T11:25:42.523Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 303966- slug: product-303966+ name: Product 335282+ slug: product-335282options_text: ''price: '10.0'display_price: "$10.00"@@ -3589,37 +3610,37 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:37.355Z'- updated_at: '2026-02-26T16:06:37.355Z'+ created_at: '2026-02-27T11:25:42.504Z'+ updated_at: '2026-02-27T11:25:42.504Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_gbHJdmfrXB- number: H83993143341+ number: H98622872027state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:37.364Z'- updated_at: '2026-02-26T16:06:37.376Z'+ created_at: '2026-02-27T11:25:42.511Z'+ updated_at: '2026-02-27T11:25:42.521Z'shipping_method:id: shpm_gbHJdmfrXBname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_153- name: Cassandra Kunde+ state_abbr: STATE_ABBR_159+ name: Sonya Deckowaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_153+ state_text: STATE_ABBR_159shipping_rates:- id: shpr_gbHJdmfrXBshipping_method_id: shpm_gbHJdmfrXB@@ -3637,7 +3658,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 157 Lovely Street+ address1: 163 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3645,15 +3666,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_157- state_abbr: STATE_ABBR_157- state_name: STATE_NAME_157+ state_text: STATE_ABBR_163+ state_abbr: STATE_ABBR_163+ state_name: STATE_NAME_163ship_address:id: addr_OIJLhNcSbffirstname: Johnlastname: Doefull_name: John Doe- address1: 158 Lovely Street+ address1: 164 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3661,9 +3682,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_158- state_abbr: STATE_ABBR_158- state_name: STATE_NAME_158+ state_text: STATE_ABBR_164+ state_abbr: STATE_ABBR_164+ state_name: STATE_NAME_164payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -3734,16 +3755,16 @@ paths:type: stringresponses:'200':- description: order updated+ description: order updated with metadatacontent:application/json:example:id: or_UkLWZg9DAJ- number: R211667730+ number: R704556930state: cart- token: Xd1teakK9MvNmzE1xZCQoqELjpKZ9CJLg7K- email: [email protected]- special_instructions: Leave at door+ token: ks2T74pgtwkQaU1yrPLYXVHYaQmw81iTTih+ email: [email protected]+ special_instructions:currency: USDlocale: enitem_count: 1@@ -3766,16 +3787,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:39.520Z'- updated_at: '2026-02-26T16:06:39.592Z'+ created_at: '2026-02-27T11:25:45.356Z'+ updated_at: '2026-02-27T11:25:45.427Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 335541- slug: product-335541+ name: Product 372870+ slug: product-372870options_text: ''price: '10.0'display_price: "$10.00"@@ -3794,37 +3815,37 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:39.555Z'- updated_at: '2026-02-26T16:06:39.555Z'+ created_at: '2026-02-27T11:25:45.393Z'+ updated_at: '2026-02-27T11:25:45.393Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H92007203717+ number: H88881688945state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:39.560Z'- updated_at: '2026-02-26T16:06:39.576Z'+ created_at: '2026-02-27T11:25:45.398Z'+ updated_at: '2026-02-27T11:25:45.412Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_168- name: Kathrine Buckridge+ state_abbr: STATE_ABBR_178+ name: Carrol Weimannaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_168+ state_text: STATE_ABBR_178shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -3842,7 +3863,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 170 Lovely Street+ address1: 180 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3850,15 +3871,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_170- state_abbr: STATE_ABBR_170- state_name: STATE_NAME_170+ state_text: STATE_ABBR_180+ state_abbr: STATE_ABBR_180+ state_name: STATE_NAME_180ship_address:id: addr_VqXmZF31wYfirstname: Johnlastname: Doefull_name: John Doe- address1: 171 Lovely Street+ address1: 181 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -3866,9 +3887,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_171- state_abbr: STATE_ABBR_171- state_name: STATE_NAME_171+ state_text: STATE_ABBR_181+ state_abbr: STATE_ABBR_181+ state_name: STATE_NAME_181payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -3898,6 +3919,12 @@ paths:special_instructions:type: stringexample: Leave at door+ metadata:+ type: object+ additionalProperties: true+ description: Arbitrary key-value metadata (merged with existing)+ example:+ source: mobile_appbill_address:type: objectproperties:@@ -4014,10 +4041,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R151590989+ number: R500465309state: address- token: heV3JDRqV1dtHv4JqzWDM48j21TkXNqMm4m- email: [email protected]+ token: PkQuTpxwfu5jtLHPvFCE998BM1yCVzTjNXW+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4041,16 +4068,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:06:40.887Z'- updated_at: '2026-02-26T16:06:40.955Z'+ created_at: '2026-02-27T11:25:46.825Z'+ updated_at: '2026-02-27T11:25:46.923Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 37843- slug: product-37843+ name: Product 419094+ slug: product-419094options_text: ''price: '10.0'display_price: "$10.00"@@ -4069,37 +4096,37 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:40.916Z'- updated_at: '2026-02-26T16:06:40.916Z'+ created_at: '2026-02-27T11:25:46.878Z'+ updated_at: '2026-02-27T11:25:46.878Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_gbHJdmfrXB- number: H52890589487+ number: H29987890608state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:40.924Z'- updated_at: '2026-02-26T16:06:40.937Z'+ created_at: '2026-02-27T11:25:46.891Z'+ updated_at: '2026-02-27T11:25:46.905Z'shipping_method:id: shpm_gbHJdmfrXBname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_178- name: Tommye Schmeler+ state_abbr: STATE_ABBR_188+ name: Gregorio Lakinaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_178+ state_text: STATE_ABBR_188shipping_rates:- id: shpr_gbHJdmfrXBshipping_method_id: shpm_gbHJdmfrXB@@ -4117,7 +4144,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 182 Lovely Street+ address1: 192 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -4125,15 +4152,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_182- state_abbr: STATE_ABBR_182- state_name: STATE_NAME_182+ state_text: STATE_ABBR_192+ state_abbr: STATE_ABBR_192+ state_name: STATE_NAME_192ship_address:id: addr_OIJLhNcSbffirstname: Johnlastname: Doefull_name: John Doe- address1: 183 Lovely Street+ address1: 193 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -4141,9 +4168,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_183- state_abbr: STATE_ABBR_183- state_name: STATE_NAME_183+ state_text: STATE_ABBR_193+ state_abbr: STATE_ABBR_193+ state_name: STATE_NAME_193payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -4209,10 +4236,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R387628664+ number: R416534571state: payment- token: emaMP4HvqjqkeBoQbWzv5orZgWCsdkukyVu- email: [email protected]+ token: 6y2usxCbsKB8L4dRJy5U41Kna8cqB4Thdwq+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4236,16 +4263,16 @@ paths:total: '29.99'display_total: "$29.99"completed_at:- created_at: '2026-02-26T16:06:42.230Z'- updated_at: '2026-02-26T16:06:42.371Z'+ created_at: '2026-02-27T11:25:48.295Z'+ updated_at: '2026-02-27T11:25:48.477Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 408267- slug: product-408267+ name: Product 445391+ slug: product-445391options_text: ''price: '19.99'display_price: "$19.99"@@ -4264,37 +4291,37 @@ paths:discounted_amount: '19.99'display_discounted_amount: "$19.99"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:42.261Z'- updated_at: '2026-02-26T16:06:42.312Z'+ created_at: '2026-02-27T11:25:48.359Z'+ updated_at: '2026-02-27T11:25:48.415Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_EfhxLZ9ck8- number: H07035178380+ number: H22515195903state: pendingtracking:tracking_url:cost: '10.0'display_cost: "$10.00"shipped_at:- created_at: '2026-02-26T16:06:42.330Z'- updated_at: '2026-02-26T16:06:42.345Z'+ created_at: '2026-02-27T11:25:48.432Z'+ updated_at: '2026-02-27T11:25:48.447Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_188- name: Anitra Conroy+ state_abbr: STATE_ABBR_198+ name: Elza Priceaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_188+ state_text: STATE_ABBR_198shipping_rates:- id: shpr_EfhxLZ9ck8shipping_method_id: shpm_UkLWZg9DAJ@@ -4322,7 +4349,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 192 Lovely Street+ address1: 202 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -4330,15 +4357,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_192- state_abbr: STATE_ABBR_192- state_name: STATE_NAME_192+ state_text: STATE_ABBR_202+ state_abbr: STATE_ABBR_202+ state_name: STATE_NAME_202ship_address:id: addr_OIJLhNcSbffirstname: Johnlastname: Doefull_name: John Doe- address1: 193 Lovely Street+ address1: 203 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -4346,9 +4373,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_193- state_abbr: STATE_ABBR_193- state_name: STATE_NAME_193+ state_text: STATE_ABBR_203+ state_abbr: STATE_ABBR_203+ state_name: STATE_NAME_203payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -4403,10 +4430,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R263983914+ number: R682958503state: complete- token: 7MN1mJ9Xfbgq5zHdr2rsXsXiLLesNWrMVgh- email: [email protected]+ token: XMmf7jiDjKo4fCgy6RfTk64PqKmLUDDAvUY+ email: [email protected]special_instructions:currency: USDlocale: en@@ -4429,17 +4456,17 @@ paths:display_additional_tax_total: "$0.00"total: '29.99'display_total: "$29.99"- completed_at: '2026-02-26T16:06:43.216Z'- created_at: '2026-02-26T16:06:42.998Z'- updated_at: '2026-02-26T16:06:43.216Z'+ completed_at: '2026-02-27T11:25:49.378Z'+ created_at: '2026-02-27T11:25:49.183Z'+ updated_at: '2026-02-27T11:25:49.378Z'order_promotions: []line_items:- id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 1currency: USD- name: Product 424684- slug: product-424684+ name: Product 462346+ slug: product-462346options_text: ''price: '19.99'display_price: "$19.99"@@ -4458,37 +4485,37 @@ paths:discounted_amount: '19.99'display_discounted_amount: "$19.99"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:06:43.037Z'- updated_at: '2026-02-26T16:06:43.214Z'+ created_at: '2026-02-27T11:25:49.214Z'+ updated_at: '2026-02-27T11:25:49.376Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_EfhxLZ9ck8- number: H89931858575+ number: H39473906157state: pendingtracking:tracking_url:cost: '10.0'display_cost: "$10.00"shipped_at:- created_at: '2026-02-26T16:06:43.117Z'- updated_at: '2026-02-26T16:06:43.204Z'+ created_at: '2026-02-27T11:25:49.285Z'+ updated_at: '2026-02-27T11:25:49.367Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_194- name: Ozella Schumm+ state_abbr: STATE_ABBR_204+ name: Wilfredo Kleinaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_194+ state_text: STATE_ABBR_204shipping_rates:- id: shpr_EfhxLZ9ck8shipping_method_id: shpm_UkLWZg9DAJ@@ -4515,11 +4542,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PFVO4BKA+ number: P0ZPI173amount: '29.99'display_amount: "$29.99"- created_at: '2026-02-26T16:06:43.173Z'- updated_at: '2026-02-26T16:06:43.173Z'+ created_at: '2026-02-27T11:25:49.341Z'+ updated_at: '2026-02-27T11:25:49.341Z'source_type: credit_cardsource_id: card_UkLWZg9DAJsource:@@ -4542,7 +4569,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 198 Lovely Street+ address1: 208 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -4550,15 +4577,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_198- state_abbr: STATE_ABBR_198- state_name: STATE_NAME_198+ state_text: STATE_ABBR_208+ state_abbr: STATE_ABBR_208+ state_name: STATE_NAME_208ship_address:id: addr_OIJLhNcSbffirstname: Johnlastname: Doefull_name: John Doe- address1: 199 Lovely Street+ address1: 209 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -4566,9 +4593,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_199- state_abbr: STATE_ABBR_199- state_name: STATE_NAME_199+ state_text: STATE_ABBR_209+ state_abbr: STATE_ABBR_209+ state_name: STATE_NAME_209payment_methods:- id: pm_UkLWZg9DAJname: Check@@ -4743,13 +4770,13 @@ paths:id: ps_gbHJdmfrXBstatus: pendingcurrency: USD- external_id: bogus_a35846384dfec32fa182f9f4+ external_id: bogus_18b0797957794aa7eec701d0external_data:- client_secret: bogus_secret_e12b873786b78a6f+ client_secret: bogus_secret_aa0dc4c39c8c62e2customer_external_id:expires_at:- created_at: '2026-02-26T16:06:45.817Z'- updated_at: '2026-02-26T16:06:45.817Z'+ created_at: '2026-02-27T11:25:52.061Z'+ updated_at: '2026-02-27T11:25:52.061Z'amount: '110.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -4854,13 +4881,13 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_b483cb208f4fa3aca12331a4+ external_id: bogus_7f00e844132136cfbbc550d6external_data:client_secret: secret_123customer_external_id:expires_at:- created_at: '2026-02-26T16:06:47.069Z'- updated_at: '2026-02-26T16:06:47.069Z'+ created_at: '2026-02-27T11:25:53.308Z'+ updated_at: '2026-02-27T11:25:53.308Z'amount: '110.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -4917,13 +4944,13 @@ paths:id: ps_UkLWZg9DAJstatus: pendingcurrency: USD- external_id: bogus_7bbf029c12ede1b13b7a38ee+ external_id: bogus_f53d8427312bc1c2869da0a1external_data:client_secret: secret_123customer_external_id:expires_at:- created_at: '2026-02-26T16:06:48.322Z'- updated_at: '2026-02-26T16:06:48.336Z'+ created_at: '2026-02-27T11:25:54.550Z'+ updated_at: '2026-02-27T11:25:54.568Z'amount: '50.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -5014,13 +5041,13 @@ paths:id: ps_UkLWZg9DAJstatus: completedcurrency: USD- external_id: bogus_13f93fdf6baa1fe9071cccdd+ external_id: bogus_2e4fae2b1375b4f47db08077external_data:client_secret: secret_123customer_external_id:expires_at:- created_at: '2026-02-26T16:06:48.959Z'- updated_at: '2026-02-26T16:06:48.975Z'+ created_at: '2026-02-27T11:25:55.203Z'+ updated_at: '2026-02-27T11:25:55.221Z'amount: '110.0'payment_method_id: pm_UkLWZg9DAJorder_id: or_UkLWZg9DAJ@@ -5100,11 +5127,11 @@ paths:example:id: pss_gbHJdmfrXBstatus: pending- external_id: bogus_seti_83ea1b70ca0777a7731c3ba2- external_client_secret: bogus_seti_secret_8cafb86d39c598c5+ external_id: bogus_seti_165d205fe0a7301172f843ea+ external_client_secret: bogus_seti_secret_07380fa10dc32883external_data: {}- created_at: '2026-02-26T16:06:50.178Z'- updated_at: '2026-02-26T16:06:50.178Z'+ created_at: '2026-02-27T11:25:56.430Z'+ updated_at: '2026-02-27T11:25:56.430Z'payment_method_id: pm_UkLWZg9DAJpayment_source_id:payment_source_type:@@ -5201,12 +5228,12 @@ paths:example:id: pss_UkLWZg9DAJstatus: pending- external_id: seti_test_75a798944200a6e4b5fa7cfe- external_client_secret: seti_secret_5fd237f5eade04d0eb069878+ external_id: seti_test_3c112c20690e8032716b7fbe+ external_client_secret: seti_secret_af8d141ac32b48c082fac0d6external_data:client_secret: secret_123- created_at: '2026-02-26T16:06:51.806Z'- updated_at: '2026-02-26T16:06:51.806Z'+ created_at: '2026-02-27T11:25:58.156Z'+ updated_at: '2026-02-27T11:25:58.156Z'payment_method_id: pm_UkLWZg9DAJpayment_source_id:payment_source_type:@@ -5279,12 +5306,12 @@ paths:example:id: pss_UkLWZg9DAJstatus: completed- external_id: seti_test_9fda407f2651357c30480aa0- external_client_secret: seti_secret_dc0c917b78e49b3646c2cbcb+ external_id: seti_test_adbc64534e90b2fe277cc182+ external_client_secret: seti_secret_dab3d1eb6f3a93213383fd28external_data:client_secret: secret_123- created_at: '2026-02-26T16:06:52.904Z'- updated_at: '2026-02-26T16:06:52.915Z'+ created_at: '2026-02-27T11:25:59.294Z'+ updated_at: '2026-02-27T11:25:59.306Z'payment_method_id: pm_UkLWZg9DAJpayment_source_id: card_UkLWZg9DAJpayment_source_type: Spree::CreditCard@@ -5367,11 +5394,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PY8GCCRD+ number: PXZ31GTFamount: '110.0'display_amount: "$110.00"- created_at: '2026-02-26T16:06:54.121Z'- updated_at: '2026-02-26T16:06:54.121Z'+ created_at: '2026-02-27T11:26:00.529Z'+ updated_at: '2026-02-27T11:26:00.529Z'source_type: credit_cardsource_id: card_UkLWZg9DAJsource:@@ -5465,11 +5492,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: P1IWRAQU+ number: PLF9KUTVamount: '110.0'display_amount: "$110.00"- created_at: '2026-02-26T16:06:55.390Z'- updated_at: '2026-02-26T16:06:55.390Z'+ created_at: '2026-02-27T11:26:01.796Z'+ updated_at: '2026-02-27T11:26:01.796Z'source_type: credit_cardsource_id: card_UkLWZg9DAJsource:@@ -5569,17 +5596,18 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 592245+ name: Product 638015description: |-- Sapiente vel ipsam possimus ex assumenda tempora praesentium quae. Quia labore culpa voluptate amet veniam natus nulla. Vel velit molestiae ullam esse illo aspernatur officiis architecto.- Laudantium eaque delectus error non adipisci. Provident inventore atque culpa ut tenetur aliquid. Magni nemo saepe cupiditate aspernatur quod aliquam explicabo. Aspernatur ab illum suscipit cupiditate ratione esse.- slug: product-592245+ Et itaque pariatur possimus veritatis quas quibusdam. Totam vitae dolorem accusamus doloribus fuga vero. Aut nisi quo consectetur doloremque. Voluptas consequatur repellat delectus commodi.+ Iste repellat nam inventore architecto dolorem rerum quam. Corrupti porro mollitia fugiat numquam nihil earum. Velit officiis alias ad rem voluptates adipisci eum. Dolor non ab pariatur architecto explicabo. Fuga quam omnis atque nulla harum.+ Incidunt harum quasi doloremque laudantium qui fugit non. Commodi aliquid non inventore amet. Nemo consequatur numquam dolor veritatis recusandae. Nobis modi repudiandae rerum aspernatur rem architecto corporis beatae.+ slug: product-638015meta_description:meta_keywords:variant_count: 1- available_on: '2025-02-26T16:06:56.098Z'- created_at: '2026-02-26T16:06:56.120Z'- updated_at: '2026-02-26T16:06:56.176Z'+ available_on: '2025-02-27T11:26:02.555Z'+ created_at: '2026-02-27T11:26:02.574Z'+ updated_at: '2026-02-27T11:26:02.636Z'purchasable: truein_stock: falsebackorderable: true@@ -5599,19 +5627,17 @@ paths:price_list_id:original_price:- id: prod_gbHJdmfrXB- name: Product 607963+ name: Product 647624description: |-- Optio ipsum illum tenetur sequi. Nobis aperiam distinctio dolore pariatur. Laboriosam maxime vel facere provident nihil sapiente. Occaecati eum labore praesentium officia ducimus fuga sequi nesciunt. Excepturi deserunt eum beatae quos voluptates nostrum debitis.- Eveniet illum exercitationem beatae debitis. Aut alias harum maiores reiciendis exercitationem natus eaque. Ipsam assumenda accusantium voluptas hic vitae voluptates. Vero vel corporis repudiandae fugiat dolor error. Ipsum dolore dolor officiis itaque porro labore a enim.- Repellendus quasi amet ex porro. Ratione expedita necessitatibus cupiditate soluta repellat quas magni corrupti. Exercitationem a ut magnam accusamus. Fugiat necessitatibus adipisci ab autem labore non ad laudantium. Accusamus eum ratione quos facere hic.- Totam voluptatibus voluptas rem dignissimos sit. Voluptates dolores magni exercitationem voluptate reprehenderit laborum. Laborum explicabo in minus accusamus saepe. Incidunt provident facilis praesentium debitis perspiciatis dolore.- slug: product-607963+ At voluptas doloremque suscipit quae tenetur excepturi facere magnam. Quia earum libero culpa nemo. Sit ipsa doloremque minima quod nihil magni in ratione. Possimus repudiandae excepturi quia exercitationem placeat at nam quisquam.+ Dolorum est minima animi suscipit earum repellat. Iure laudantium incidunt fugiat earum vitae. Consectetur fugit recusandae facere perferendis praesentium tempora repellat rerum.+ slug: product-647624meta_description:meta_keywords:variant_count: 0- available_on: '2025-02-26T16:06:56.183Z'- created_at: '2026-02-26T16:06:56.197Z'- updated_at: '2026-02-26T16:06:56.211Z'+ available_on: '2025-02-27T11:26:02.644Z'+ created_at: '2026-02-27T11:26:02.658Z'+ updated_at: '2026-02-27T11:26:02.671Z'purchasable: truein_stock: falsebackorderable: true@@ -5710,18 +5736,17 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 712906- description: Hic reprehenderit reiciendis adipisci excepturi. Deleniti- voluptas culpa aperiam error ut modi voluptatem. Animi earum ab- atque illo occaecati excepturi pariatur rerum. Iusto distinctio- eveniet hic consequuntur quod.- slug: product-712906+ name: Product 75560+ description: Saepe hic nemo ipsam dolorem esse quod tenetur totam.+ Consequuntur vel exercitationem porro neque deleniti quasi sint+ cum. In dolore enim tempora unde esse.+ slug: product-75560meta_description:meta_keywords:variant_count: 1- available_on: '2025-02-26T16:06:57.103Z'- created_at: '2026-02-26T16:06:57.124Z'- updated_at: '2026-02-26T16:06:57.175Z'+ available_on: '2025-02-27T11:26:03.880Z'+ created_at: '2026-02-27T11:26:03.931Z'+ updated_at: '2026-02-27T11:26:04.021Z'purchasable: truein_stock: falsebackorderable: true@@ -5954,29 +5979,29 @@ paths:example:data:- id: ship_UkLWZg9DAJ- number: H00581383513+ number: H06560842266state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:06:59.878Z'- updated_at: '2026-02-26T16:06:59.895Z'+ created_at: '2026-02-27T11:26:07.567Z'+ updated_at: '2026-02-27T11:26:07.585Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_280- name: Vincenza Schmeler+ state_abbr: STATE_ABBR_290+ name: Diego Boehmaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_280+ state_text: STATE_ABBR_290shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -6067,29 +6092,29 @@ paths:application/json:example:id: ship_UkLWZg9DAJ- number: H44850365869+ number: H75716871460state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:07:01.138Z'- updated_at: '2026-02-26T16:07:01.153Z'+ created_at: '2026-02-27T11:26:09.022Z'+ updated_at: '2026-02-27T11:26:09.050Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_288- name: Juliana Bernhard+ state_abbr: STATE_ABBR_298+ name: Davida Lindaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_288+ state_text: STATE_ABBR_298shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -6172,10 +6197,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R844460335+ number: R201016034state: delivery- token: ix19m3o6oMjYx271o1qYgTJjJXbqLQ9Rz3f- email: [email protected]+ token: 7ae8uUJXUHNubeGEiR8bibwTELZtdrvjjER+ email: [email protected]special_instructions:currency: USDlocale: en@@ -6199,16 +6224,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:07:02.412Z'- updated_at: '2026-02-26T16:07:02.497Z'+ created_at: '2026-02-27T11:26:10.318Z'+ updated_at: '2026-02-27T11:26:10.392Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1036143- slug: product-1036143+ name: Product 1075187+ slug: product-1075187options_text: ''price: '10.0'display_price: "$10.00"@@ -6227,37 +6252,37 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:07:02.453Z'- updated_at: '2026-02-26T16:07:02.453Z'+ created_at: '2026-02-27T11:26:10.352Z'+ updated_at: '2026-02-27T11:26:10.352Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H29850229362+ number: H45900703018state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:07:02.460Z'- updated_at: '2026-02-26T16:07:02.496Z'+ created_at: '2026-02-27T11:26:10.357Z'+ updated_at: '2026-02-27T11:26:10.390Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_296- name: Annalisa Stoltenberg+ state_abbr: STATE_ABBR_306+ name: Salena Gusikowskiaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_296+ state_text: STATE_ABBR_306shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -6275,7 +6300,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 288 Lovely Street+ address1: 298 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -6283,15 +6308,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_298- state_abbr: STATE_ABBR_298- state_name: STATE_NAME_298+ state_text: STATE_ABBR_308+ state_abbr: STATE_ABBR_308+ state_name: STATE_NAME_308ship_address:id: addr_VqXmZF31wYfirstname: Johnlastname: Doefull_name: John Doe- address1: 289 Lovely Street+ address1: 299 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -6299,9 +6324,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_299- state_abbr: STATE_ABBR_299- state_name: STATE_NAME_299+ state_text: STATE_ABBR_309+ state_abbr: STATE_ABBR_309+ state_name: STATE_NAME_309payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -6378,10 +6403,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R623082718+ number: R987906210state: cart- token: RwkhfXM15QXDm4cAX8oHturaRjKhX3L7naL- email: [email protected]+ token: HDvKVabJVZQAXzmE9HZ9Zu7x4ykm35GncHe+ email: [email protected]special_instructions:currency: USDlocale: en@@ -6405,16 +6430,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:07:03.663Z'- updated_at: '2026-02-26T16:07:04.023Z'+ created_at: '2026-02-27T11:26:11.577Z'+ updated_at: '2026-02-27T11:26:11.938Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1053979- slug: product-1053979+ name: Product 1092051+ slug: product-1092051options_text: ''price: '10.0'display_price: "$10.00"@@ -6433,37 +6458,37 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:07:03.695Z'- updated_at: '2026-02-26T16:07:03.695Z'+ created_at: '2026-02-27T11:26:11.608Z'+ updated_at: '2026-02-27T11:26:11.608Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H77762020401+ number: H86001924906state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:07:03.701Z'- updated_at: '2026-02-26T16:07:03.715Z'+ created_at: '2026-02-27T11:26:11.613Z'+ updated_at: '2026-02-27T11:26:11.626Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_304- name: Dexter Keebler+ state_abbr: STATE_ABBR_314+ name: Harris Leuschkeaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_304+ state_text: STATE_ABBR_314shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -6479,12 +6504,12 @@ paths:- id: py_UkLWZg9DAJpayment_method_id: pm_UkLWZg9DAJstate: checkout- response_code: 1-SC-20260226160704018453- number: PKV3NO72+ response_code: 1-SC-20260227112611934896+ number: POI0EPPZamount: '10.0'display_amount: "$10.00"- created_at: '2026-02-26T16:07:04.022Z'- updated_at: '2026-02-26T16:07:04.022Z'+ created_at: '2026-02-27T11:26:11.938Z'+ updated_at: '2026-02-27T11:26:11.938Z'source_type: store_creditsource_id: credit_UkLWZg9DAJsource:@@ -6507,7 +6532,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 296 Lovely Street+ address1: 306 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -6515,15 +6540,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_306- state_abbr: STATE_ABBR_306- state_name: STATE_NAME_306+ state_text: STATE_ABBR_316+ state_abbr: STATE_ABBR_316+ state_name: STATE_NAME_316ship_address:id: addr_VqXmZF31wYfirstname: Johnlastname: Doefull_name: John Doe- address1: 297 Lovely Street+ address1: 307 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -6531,9 +6556,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_307- state_abbr: STATE_ABBR_307- state_name: STATE_NAME_307+ state_text: STATE_ABBR_317+ state_abbr: STATE_ABBR_317+ state_name: STATE_NAME_317payment_methods:- id: pm_UkLWZg9DAJname: Store Credit@@ -6612,10 +6637,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R686595009+ number: R403322953state: cart- token: BEn5aWH53b8zEh26iU6wgZbpfJNvfoBPdza- email: [email protected]+ token: SwSMs3aC1zTseqymPUAvxg2xsZtCMsGyWdP+ email: [email protected]special_instructions:currency: USDlocale: en@@ -6639,16 +6664,16 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-26T16:07:05.214Z'- updated_at: '2026-02-26T16:07:05.274Z'+ created_at: '2026-02-27T11:26:13.158Z'+ updated_at: '2026-02-27T11:26:13.219Z'order_promotions: []line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1currency: USD- name: Product 1078975- slug: product-1078975+ name: Product 1115669+ slug: product-1115669options_text: ''price: '10.0'display_price: "$10.00"@@ -6667,37 +6692,37 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-26T16:07:05.250Z'- updated_at: '2026-02-26T16:07:05.250Z'+ created_at: '2026-02-27T11:26:13.195Z'+ updated_at: '2026-02-27T11:26:13.195Z'compare_at_amount:thumbnail_url:option_values: []digital_links: []shipments:- id: ship_UkLWZg9DAJ- number: H69105341832+ number: H64700520139state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-26T16:07:05.256Z'- updated_at: '2026-02-26T16:07:05.272Z'+ created_at: '2026-02-27T11:26:13.202Z'+ updated_at: '2026-02-27T11:26:13.216Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_312- name: Della Erdman+ state_abbr: STATE_ABBR_322+ name: Melani Robertsaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_312+ state_text: STATE_ABBR_322shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -6715,7 +6740,7 @@ paths:firstname: Johnlastname: Doefull_name: John Doe- address1: 304 Lovely Street+ address1: 314 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -6723,15 +6748,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_314- state_abbr: STATE_ABBR_314- state_name: STATE_NAME_314+ state_text: STATE_ABBR_324+ state_abbr: STATE_ABBR_324+ state_name: STATE_NAME_324ship_address:id: addr_VqXmZF31wYfirstname: Johnlastname: Doefull_name: John Doe- address1: 305 Lovely Street+ address1: 315 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -6739,9 +6764,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_315- state_abbr: STATE_ABBR_315- state_name: STATE_NAME_315+ state_text: STATE_ABBR_325+ state_abbr: STATE_ABBR_325+ state_name: STATE_NAME_325payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -6788,8 +6813,8 @@ paths:twitter: spreecommerceinstagram: spreecommercecustomer_support_email: [email protected]- created_at: '2026-02-26T16:06:02.056Z'- updated_at: '2026-02-26T16:06:02.164Z'+ created_at: '2026-02-27T11:25:04.396Z'+ updated_at: '2026-02-27T11:25:04.507Z'favicon_image_url:logo_image_url:social_image_url:@@ -6862,32 +6887,32 @@ paths:- id: txnmy_UkLWZg9DAJname: Categoriesposition: 1- created_at: '2026-02-26T16:06:02.066Z'- updated_at: '2026-02-26T16:06:02.086Z'+ created_at: '2026-02-27T11:25:04.410Z'+ updated_at: '2026-02-27T11:25:04.431Z'root_id: txn_UkLWZg9DAJ- id: txnmy_gbHJdmfrXBname: Brandsposition: 2- created_at: '2026-02-26T16:06:02.087Z'- updated_at: '2026-02-26T16:06:02.097Z'+ created_at: '2026-02-27T11:25:04.432Z'+ updated_at: '2026-02-27T11:25:04.439Z'root_id: txn_gbHJdmfrXB- id: txnmy_EfhxLZ9ck8name: Collectionsposition: 3- created_at: '2026-02-26T16:06:02.099Z'- updated_at: '2026-02-26T16:06:02.167Z'+ created_at: '2026-02-27T11:25:04.440Z'+ updated_at: '2026-02-27T11:25:04.510Z'root_id: txn_EfhxLZ9ck8- id: txnmy_VqXmZF31wYname: taxonomy_11position: 4- created_at: '2026-02-26T16:07:05.347Z'- updated_at: '2026-02-26T16:07:05.355Z'+ created_at: '2026-02-27T11:26:13.308Z'+ updated_at: '2026-02-27T11:26:13.317Z'root_id: txn_OIJLhNcSbf- id: txnmy_uw2YK1rnl0name: taxonomy_12position: 5- created_at: '2026-02-26T16:07:05.356Z'- updated_at: '2026-02-26T16:07:05.363Z'+ created_at: '2026-02-27T11:26:13.318Z'+ updated_at: '2026-02-27T11:26:13.327Z'root_id: txn_AXs1igzRC6meta:page: 1@@ -6967,8 +6992,8 @@ paths:id: txnmy_VqXmZF31wYname: taxonomy_17position: 4- created_at: '2026-02-26T16:07:05.634Z'- updated_at: '2026-02-26T16:07:05.642Z'+ created_at: '2026-02-27T11:26:13.602Z'+ updated_at: '2026-02-27T11:26:13.611Z'root_id: txn_OIJLhNcSbfschema:"$ref": "#/components/schemas/StoreTaxonomy"@@ -7044,8 +7069,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-02-26T16:06:02.077Z'- updated_at: '2026-02-26T16:06:02.085Z'+ created_at: '2026-02-27T11:25:04.422Z'+ updated_at: '2026-02-27T11:25:04.429Z'parent_id:taxonomy_id: txnmy_UkLWZg9DAJdescription: ''@@ -7064,8 +7089,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-02-26T16:06:02.090Z'- updated_at: '2026-02-26T16:06:02.093Z'+ created_at: '2026-02-27T11:25:04.434Z'+ updated_at: '2026-02-27T11:25:04.438Z'parent_id:taxonomy_id: txnmy_gbHJdmfrXBdescription: ''@@ -7084,8 +7109,8 @@ paths:meta_description:meta_keywords:children_count: 2- created_at: '2026-02-26T16:06:02.102Z'- updated_at: '2026-02-26T16:06:02.167Z'+ created_at: '2026-02-27T11:25:04.442Z'+ updated_at: '2026-02-27T11:25:04.510Z'parent_id:taxonomy_id: txnmy_EfhxLZ9ck8description: ''@@ -7104,8 +7129,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-02-26T16:06:02.114Z'- updated_at: '2026-02-26T16:06:02.115Z'+ created_at: '2026-02-27T11:25:04.454Z'+ updated_at: '2026-02-27T11:25:04.456Z'parent_id: txn_EfhxLZ9ck8taxonomy_id: txnmy_EfhxLZ9ck8description: ''@@ -7124,8 +7149,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-02-26T16:06:02.126Z'- updated_at: '2026-02-26T16:06:02.127Z'+ created_at: '2026-02-27T11:25:04.468Z'+ updated_at: '2026-02-27T11:25:04.469Z'parent_id: txn_EfhxLZ9ck8taxonomy_id: txnmy_EfhxLZ9ck8description: ''@@ -7144,8 +7169,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-02-26T16:07:06.138Z'- updated_at: '2026-02-26T16:07:06.247Z'+ created_at: '2026-02-27T11:26:14.113Z'+ updated_at: '2026-02-27T11:26:14.173Z'parent_id:taxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7164,8 +7189,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-02-26T16:07:06.161Z'- updated_at: '2026-02-26T16:07:06.246Z'+ created_at: '2026-02-27T11:26:14.123Z'+ updated_at: '2026-02-27T11:26:14.173Z'parent_id: txn_OIJLhNcSbftaxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7184,8 +7209,8 @@ paths:meta_description:meta_keywords:children_count: 0- created_at: '2026-02-26T16:07:06.178Z'- updated_at: '2026-02-26T16:07:06.191Z'+ created_at: '2026-02-27T11:26:14.134Z'+ updated_at: '2026-02-27T11:26:14.142Z'parent_id: txn_AXs1igzRC6taxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7280,8 +7305,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-02-26T16:07:06.841Z'- updated_at: '2026-02-26T16:07:06.881Z'+ created_at: '2026-02-27T11:26:14.726Z'+ updated_at: '2026-02-27T11:26:14.766Z'parent_id: txn_OIJLhNcSbftaxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -7367,19 +7392,19 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 1151850+ name: Product 1195552description: |-- Fugiat facilis itaque impedit veritatis suscipit porro doloremque ab. Optio vitae ab tempora aliquid pariatur eveniet doloribus. Ducimus reprehenderit repudiandae ut voluptatum dolorem officiis. Quos ducimus architecto laborum aliquid.- Voluptatem voluptate blanditiis esse ducimus animi officia. Ducimus commodi odit dolores consequuntur. Debitis aut molestiae cumque placeat. Amet at a minima sit illo.- Soluta aperiam amet doloremque iste cumque animi laboriosam. Assumenda aliquam porro perferendis magnam quibusdam doloribus error. Dignissimos tenetur deserunt harum ratione animi. Quisquam atque eveniet autem molestiae harum voluptas laudantium facilis.- Laboriosam minus pariatur corrupti modi. Officiis tempore temporibus in provident ratione culpa. Iste architecto omnis beatae distinctio. Nobis ea molestias possimus tempora. Quasi nam est in odit.- slug: product-1151850+ Deserunt necessitatibus quasi debitis magni illo veniam sequi. Ipsa occaecati nesciunt amet ullam doloribus. Ipsum doloremque quis quae cum deserunt.+ Dolor minus pariatur eaque et repudiandae. Alias sunt porro quibusdam minima eaque inventore. Nihil repellat necessitatibus vero excepturi ipsum. Odio asperiores nihil doloribus dignissimos expedita architecto sunt.+ Assumenda corrupti qui totam doloremque. Dignissimos voluptate ratione eligendi officiis. Quod consequatur vero quas id. Eligendi quod ullam recusandae exercitationem ipsa inventore rem eveniet.+ Deleniti nesciunt voluptates rem suscipit ullam aut. Eum distinctio molestiae quod cum magnam. Dolore voluptatem omnis odio ullam nobis fuga. Esse debitis sunt quis deserunt.+ slug: product-1195552meta_description:meta_keywords:variant_count: 0- available_on: '2025-02-26T16:07:07.825Z'- created_at: '2026-02-26T16:07:07.843Z'- updated_at: '2026-02-26T16:07:07.859Z'+ available_on: '2025-02-27T11:26:15.686Z'+ created_at: '2026-02-27T11:26:15.705Z'+ updated_at: '2026-02-27T11:26:15.720Z'purchasable: truein_stock: falsebackorderable: true@@ -7490,9 +7515,9 @@ paths:data:- id: wl_UkLWZg9DAJname: My Wishlist- token: 4yP2gFKtvZqvwXsvs9ccmjDU- created_at: '2026-02-26T16:07:08.934Z'- updated_at: '2026-02-26T16:07:08.934Z'+ token: 5PBMaHbY6fzo1zgb7J2TZHAh+ created_at: '2026-02-27T11:26:16.853Z'+ updated_at: '2026-02-27T11:26:16.853Z'is_default: falseis_private: truemeta:@@ -7568,9 +7593,9 @@ paths:example:id: wl_gbHJdmfrXBname: Birthday Ideas- token: bEZMqZHuvxFfo8SwSMzDBbxR- created_at: '2026-02-26T16:07:10.155Z'- updated_at: '2026-02-26T16:07:10.155Z'+ token: FszKoT6gcUaHfkFRGVRnnjxJ+ created_at: '2026-02-27T11:26:18.140Z'+ updated_at: '2026-02-27T11:26:18.140Z'is_default: falseis_private: trueschema:@@ -7659,9 +7684,9 @@ paths:example:id: wl_UkLWZg9DAJname: My Wishlist- token: GQXNVQ8hEz2HaDVmSxti5QAg- created_at: '2026-02-26T16:07:11.274Z'- updated_at: '2026-02-26T16:07:11.274Z'+ token: N37RPx2tsTsFjW1GaURbgKzW+ created_at: '2026-02-27T11:26:19.398Z'+ updated_at: '2026-02-27T11:26:19.398Z'is_default: falseis_private: trueschema:@@ -7723,9 +7748,9 @@ paths:example:id: wl_UkLWZg9DAJname: Updated Name- token: zxYXceeDiZD1MeKy7AA9RvK8- created_at: '2026-02-26T16:07:12.483Z'- updated_at: '2026-02-26T16:07:12.541Z'+ token: AkiqUpLgxkoEZoPYNH6Lzzy4+ created_at: '2026-02-27T11:26:20.628Z'+ updated_at: '2026-02-27T11:26:20.685Z'is_default: falseis_private: trueschema:@@ -7837,18 +7862,18 @@ paths:variant_id: variant_gbHJdmfrXBwishlist_id: wl_UkLWZg9DAJquantity: 1- created_at: '2026-02-26T16:07:13.772Z'- updated_at: '2026-02-26T16:07:13.772Z'+ created_at: '2026-02-27T11:26:22.002Z'+ updated_at: '2026-02-27T11:26:22.002Z'variant:id: variant_gbHJdmfrXBproduct_id: prod_gbHJdmfrXB- sku: SKU-137+ sku: SKU-141is_master: trueoptions_text: ''track_inventory: trueimage_count: 0- created_at: '2026-02-26T16:07:13.745Z'- updated_at: '2026-02-26T16:07:13.756Z'+ created_at: '2026-02-27T11:26:21.980Z'+ updated_at: '2026-02-27T11:26:21.988Z'thumbnail:purchasable: truein_stock: false@@ -9909,13 +9934,9 @@ components:gateway_payment_profile_id:type: stringnullable: true- public_metadata:- type: object- nullable: truerequired:- id- gateway_payment_profile_id- - public_metadatax-typelizer: trueStorePostCategory:type: objectdiff --git a/packages/next/.changeset/deprecate-store-checkout-zone.md b/packages/next/.changeset/deprecate-store-checkout-zone.mddeleted file mode 100644index ed2ece9344..0000000000--- a/packages/next/.changeset/deprecate-store-checkout-zone.md+++ /dev/null@@ -1,5 +0,0 @@-----'@spree/next': patch------Update `StoreStore` type — fields removed upstream in `@spree/sdk` (`default_currency`, `default_locale`, `default`, `supported_currencies`, `supported_locales`, `default_country_iso`) are no longer part of the store response. Use dedicated `listCurrencies`, `listLocales`, and `listCountries` functions instead.diff --git a/packages/next/CHANGELOG.md b/packages/next/CHANGELOG.mdindex 8797257bd6..c62fe1493f 100644--- a/packages/next/CHANGELOG.md+++ b/packages/next/CHANGELOG.md@@ -1,5 +1,23 @@# @spree/next+## 0.6.0++### Minor Changes++- Add `metadata` support to cart actions++ - `getOrCreateCart()` now accepts optional `metadata` parameter for setting metadata on new carts+ - `addItem()` now accepts optional `metadata` parameter: `addItem(variantId, quantity, metadata)`+ - **Breaking:** `updateItem()` signature changed from `(lineItemId, quantity)` to `(lineItemId, { quantity?, metadata? })` — pass an object with `quantity` and/or `metadata` keys+ - Updated `@spree/sdk` peer dependency++### Patch Changes++- Update `StoreStore` type — fields removed upstream in `@spree/sdk` (`default_currency`, `default_locale`, `default`, `supported_currencies`, `supported_locales`, `default_country_iso`) are no longer part of the store response. Use dedicated `listCurrencies`, `listLocales`, and `listCountries` functions instead.++- Updated dependencies:+ - @spree/[email protected]+## 0.5.0### Minor Changesdiff --git a/packages/next/README.md b/packages/next/README.mdindex a9da4815a0..30599cbee0 100644--- a/packages/next/README.md+++ b/packages/next/README.md@@ -133,8 +133,9 @@ import { getCart, getOrCreateCart, addItem, updateItem, removeItem, clearCart }const cart = await getCart();const cart = await getOrCreateCart();-await addItem(variantId, quantity);-await updateItem(lineItemId, quantity);+await addItem(variantId, quantity, { gift_message: 'Happy Birthday!' });+await updateItem(lineItemId, { quantity: 3 });+await updateItem(lineItemId, { metadata: { engraving: 'J.D.' } });await removeItem(lineItemId);await clearCart();```diff --git a/packages/next/package.json b/packages/next/package.jsonindex ba89508638..da164455fc 100644--- a/packages/next/package.json+++ b/packages/next/package.json@@ -1,6 +1,6 @@{"name": "@spree/next",- "version": "0.5.0",+ "version": "0.6.0","description": "Next.js integration for Spree Commerce — server actions, caching, and cookie-based auth","type": "module","main": "./dist/index.js",@@ -55,7 +55,7 @@"url": "https://github.com/spree/spree/issues"},"peerDependencies": {- "@spree/sdk": ">=0.5.0",+ "@spree/sdk": ">=0.6.0","next": ">=15.0.0","react": ">=19.0.0"},diff --git a/packages/next/src/actions/cart.ts b/packages/next/src/actions/cart.tsindex ff7d0b3db7..6c278a64bb 100644--- a/packages/next/src/actions/cart.ts+++ b/packages/next/src/actions/cart.ts@@ -26,13 +26,17 @@ export async function getCart(): Promise<(StoreOrder & { token: string }) | null/*** Get existing cart or create a new one.+ * @param metadata - Optional metadata to set on the cart when creating a new one*/-export async function getOrCreateCart(): Promise<StoreOrder & { token: string }> {+export async function getOrCreateCart(+ metadata?: Record<string, unknown>+): Promise<StoreOrder & { token: string }> {const existing = await getCart();if (existing) return existing;const token = await getAccessToken();- const cart = await getClient().store.cart.create(token ? { token } : undefined);+ const cartParams = metadata ? { metadata } : undefined;+ const cart = await getClient().store.cart.create(cartParams, token ? { token } : undefined);if (cart.token) {await setCartToken(cart.token);@@ -48,7 +52,8 @@ export async function getOrCreateCart(): Promise<StoreOrder & { token: string }>*/export async function addItem(variantId: string,- quantity: number = 1+ quantity: number = 1,+ metadata?: Record<string, unknown>): Promise<StoreOrder> {const cart = await getOrCreateCart();const orderToken = cart.token;@@ -56,7 +61,7 @@ export async function addItem(const order = await getClient().store.orders.lineItems.create(cart.id,- { variant_id: variantId, quantity },+ { variant_id: variantId, quantity, metadata },{ orderToken, token });@@ -65,12 +70,22 @@ export async function addItem(}/**- * Update a line item quantity in the cart.+ * Update a line item in the cart (quantity and/or metadata).* Returns the updated order with recalculated totals.+ *+ * @example+ * // Update quantity only+ * await updateItem(lineItemId, { quantity: 3 })+ *+ * // Update metadata only+ * await updateItem(lineItemId, { metadata: { gift_message: 'Happy Birthday!' } })+ *+ * // Update both+ * await updateItem(lineItemId, { quantity: 2, metadata: { engraving: 'J.D.' } })*/export async function updateItem(lineItemId: string,- quantity: number+ params: { quantity?: number; metadata?: Record<string, unknown> }): Promise<StoreOrder> {const orderToken = await getCartToken();const token = await getAccessToken();@@ -81,7 +96,7 @@ export async function updateItem(const order = await getClient().store.orders.lineItems.update(cart.id,lineItemId,- { quantity },+ params,{ orderToken, token });diff --git a/packages/sdk/.changeset/deprecate-store-checkout-zone.md b/packages/sdk/.changeset/deprecate-store-checkout-zone.mddeleted file mode 100644index 606c091c0e..0000000000--- a/packages/sdk/.changeset/deprecate-store-checkout-zone.md+++ /dev/null@@ -1,12 +0,0 @@-----'@spree/sdk': minor------Remove deprecated fields from `StoreStore` type — these are now managed through Markets and dedicated API endpoints--- Remove `default_currency` — use `store.currencies.list()` or the `X-Spree-Country` header for automatic currency resolution-- Remove `default_locale` — use `store.locales.list()` or the `X-Spree-Country` header for automatic locale resolution-- Remove `default` — internal flag, not useful for storefront clients-- Remove `supported_currencies` — use `store.currencies.list()` instead-- Remove `supported_locales` — use `store.locales.list()` instead-- Remove `default_country_iso` — use `store.countries.list()` insteaddiff --git a/packages/sdk/.changeset/slow-moments-behave.md b/packages/sdk/.changeset/slow-moments-behave.mddeleted file mode 100644index 352a738096..0000000000--- a/packages/sdk/.changeset/slow-moments-behave.md+++ /dev/null@@ -1,5 +0,0 @@-----"@spree/sdk": patch------Added missing types and zod filesdiff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.mdindex 4fc1b4ecb3..c7ca6715ff 100644--- a/packages/sdk/CHANGELOG.md+++ b/packages/sdk/CHANGELOG.md@@ -1,5 +1,32 @@# @spree/sdk+## 0.6.0++### Minor Changes++- Add `metadata` support to Store API — Stripe-style write-only key-value storage++ - Add `CreateCartParams` with optional `metadata` for setting metadata on cart creation+ - Add `metadata` parameter to `AddLineItemParams` for setting metadata when adding items to cart+ - Add `metadata` parameter to `UpdateLineItemParams` for updating line item metadata (merge semantics)+ - Add `metadata` parameter to `UpdateOrderParams` for updating order metadata (merge semantics)+ - Make `quantity` optional in `UpdateLineItemParams` (can now update metadata without changing quantity)+ - **Breaking:** `cart.create()` signature changed from `(options?)` to `(params?, options?)` — first argument is now optional `CreateCartParams`+ - Remove `public_metadata` from `StorePaymentSource` type and Zod schema++- Remove deprecated fields from `StoreStore` type — these are now managed through Markets and dedicated API endpoints++ - Remove `default_currency` — use `store.currencies.list()` or the `X-Spree-Country` header for automatic currency resolution+ - Remove `default_locale` — use `store.locales.list()` or the `X-Spree-Country` header for automatic locale resolution+ - Remove `default` — internal flag, not useful for storefront clients+ - Remove `supported_currencies` — use `store.currencies.list()` instead+ - Remove `supported_locales` — use `store.locales.list()` instead+ - Remove `default_country_iso` — use `store.countries.list()` instead++### Patch Changes++- Added missing types and zod files+## 0.5.0### Minor Changesdiff --git a/packages/sdk/package.json b/packages/sdk/package.jsonindex 87d602e265..94c8f3ced7 100644--- a/packages/sdk/package.json+++ b/packages/sdk/package.json@@ -1,6 +1,6 @@{"name": "@spree/sdk",- "version": "0.5.0",+ "version": "0.6.0","description": "Official TypeScript SDK for Spree Commerce API","type": "module","main": "./dist/index.cjs",diff --git a/packages/sdk/src/store-client.ts b/packages/sdk/src/store-client.tsindex 3b6e0e6ec0..9599d43f4c 100644--- a/packages/sdk/src/store-client.ts+++ b/packages/sdk/src/store-client.ts@@ -10,6 +10,7 @@ import type {ProductFiltersResponse,TaxonListParams,OrderListParams,+ CreateCartParams,AddLineItemParams,UpdateLineItemParams,UpdateOrderParams,@@ -266,9 +267,13 @@ export class StoreClient {/*** Create a new cart+ * @param params - Optional cart parameters (e.g., metadata)*/- create: (options?: RequestOptions): Promise<StoreOrder & { token: string }> =>- this.request<StoreOrder & { token: string }>('POST', '/cart', options),+ create: (params?: CreateCartParams, options?: RequestOptions): Promise<StoreOrder & { token: string }> =>+ this.request<StoreOrder & { token: string }>('POST', '/cart', {+ ...options,+ body: params,+ }),/*** Associate a guest cart with the currently authenticated userdiff --git a/packages/sdk/src/types/generated/AdminLineItem.ts b/packages/sdk/src/types/generated/AdminLineItem.tsnew file mode 100644index 0000000000..6f888776f5--- /dev/null+++ b/packages/sdk/src/types/generated/AdminLineItem.ts@@ -0,0 +1,40 @@+// Typelizer digest 52bda88d09fb1e853adff0abe82940a3+//+// DO NOT MODIFY: This file was automatically generated by Typelizer.+import type {StoreOptionValue, StoreDigitalLink} from '@/types'++type AdminLineItem = {+ id: string;+ variant_id: string;+ quantity: number;+ currency: string;+ name: string;+ slug: string;+ options_text: string;+ price: string;+ display_price: string;+ total: string;+ display_total: string;+ adjustment_total: string;+ display_adjustment_total: string;+ additional_tax_total: string;+ display_additional_tax_total: string;+ included_tax_total: string;+ display_included_tax_total: string;+ promo_total: string;+ display_promo_total: string;+ pre_tax_amount: string;+ display_pre_tax_amount: string;+ discounted_amount: string;+ display_discounted_amount: string;+ display_compare_at_amount: string | null;+ created_at: string;+ updated_at: string;+ compare_at_amount: string | null;+ thumbnail_url: string | null;+ option_values: Array<StoreOptionValue>;+ digital_links: Array<StoreDigitalLink>;+ metadata: Record<string, unknown> | null;+}++export default AdminLineItem;diff --git a/packages/sdk/src/types/generated/AdminOrder.ts b/packages/sdk/src/types/generated/AdminOrder.tsindex 36a2f51209..635ce1f801 100644--- a/packages/sdk/src/types/generated/AdminOrder.ts+++ b/packages/sdk/src/types/generated/AdminOrder.ts@@ -1,7 +1,7 @@-// Typelizer digest b633a39a364d8a8ed7451adf14156950+// Typelizer digest 282289c6ce94b237a517fe51d64a1461//// DO NOT MODIFY: This file was automatically generated by Typelizer.-import type {StoreOrderPromotion, StoreLineItem, StoreShipment, StorePayment, StoreAddress, StorePaymentMethod, AdminCustomer} from '@/types'+import type {StoreOrderPromotion, AdminLineItem, StoreShipment, StorePayment, StoreAddress, StorePaymentMethod, AdminCustomer} from '@/types'type AdminOrder = {id: string;@@ -35,7 +35,7 @@ type AdminOrder = {created_at: string;updated_at: string;order_promotions: Array<StoreOrderPromotion>;- line_items: Array<StoreLineItem>;+ line_items: Array<AdminLineItem>;shipments: Array<StoreShipment>;payments: Array<StorePayment>;bill_address: StoreAddress | null;@@ -50,6 +50,7 @@ type AdminOrder = {approver_id: string | null;canceled_at: string | null;approved_at: string | null;+ metadata: Record<string, unknown> | null;canceler_id: string | null;created_by_id: string | null;user?: AdminCustomer;diff --git a/packages/sdk/src/types/generated/StorePaymentSource.ts b/packages/sdk/src/types/generated/StorePaymentSource.tsindex a54048f47c..b4c3b3e00e 100644--- a/packages/sdk/src/types/generated/StorePaymentSource.ts+++ b/packages/sdk/src/types/generated/StorePaymentSource.ts@@ -1,11 +1,10 @@-// Typelizer digest cac06d7bdf1a8d6f8dfe5d26f65a8ecb+// Typelizer digest 0f0291032e0a31887d43588a3f5ecb1a//// DO NOT MODIFY: This file was automatically generated by Typelizer.type StorePaymentSource = {id: string;gateway_payment_profile_id: string | null;- public_metadata: Record<string, unknown> | null;}export default StorePaymentSource;diff --git a/packages/sdk/src/types/generated/index.ts b/packages/sdk/src/types/generated/index.tsindex 85779b082b..47701913ba 100644--- a/packages/sdk/src/types/generated/index.ts+++ b/packages/sdk/src/types/generated/index.ts@@ -1,8 +1,9 @@-// Typelizer digest dfa2e2f24b33aa259147f751dda8ff6e+// Typelizer digest 9bcce2c5fd7dc60cf1f6532ba1cbd10f//// DO NOT MODIFY: This file was automatically generated by Typelizer.export type { default as StoreAddress } from './StoreAddress'export type { default as AdminCustomer } from './AdminCustomer'+export type { default as AdminLineItem } from './AdminLineItem'export type { default as AdminMetafield } from './AdminMetafield'export type { default as AdminOrder } from './AdminOrder'export type { default as AdminPrice } from './AdminPrice'diff --git a/packages/sdk/src/types/index.ts b/packages/sdk/src/types/index.tsindex 7c5b1f0ad2..f81f789cc4 100644--- a/packages/sdk/src/types/index.ts+++ b/packages/sdk/src/types/index.ts@@ -74,13 +74,22 @@ export interface OrderListParams extends ListParams {}// Cart operations+export interface CreateCartParams {+ /** Arbitrary key-value metadata (stored, not returned in responses) */+ metadata?: Record<string, unknown>;+}+export interface AddLineItemParams {variant_id: string;quantity: number;+ /** Arbitrary key-value metadata (stored, not returned in responses) */+ metadata?: Record<string, unknown>;}export interface UpdateLineItemParams {- quantity: number;+ quantity?: number;+ /** Arbitrary key-value metadata (merged with existing) */+ metadata?: Record<string, unknown>;}// Address params@@ -106,6 +115,8 @@ export interface UpdateOrderParams {currency?: string;locale?: string;special_instructions?: string;+ /** Arbitrary key-value metadata (merged with existing) */+ metadata?: Record<string, unknown>;/** Existing address ID to use */bill_address_id?: string;/** Existing address ID to use */diff --git a/packages/sdk/src/zod/generated/AdminLineItem.ts b/packages/sdk/src/zod/generated/AdminLineItem.tsnew file mode 100644index 0000000000..c25e49a12c--- /dev/null+++ b/packages/sdk/src/zod/generated/AdminLineItem.ts@@ -0,0 +1,40 @@+// This file is auto-generated. Do not edit directly.+import { z } from 'zod';+import { StoreDigitalLinkSchema } from './StoreDigitalLink';+import { StoreOptionValueSchema } from './StoreOptionValue';++export const AdminLineItemSchema = z.object({+ id: z.string(),+ variant_id: z.string(),+ quantity: z.number(),+ currency: z.string(),+ name: z.string(),+ slug: z.string(),+ options_text: z.string(),+ price: z.string(),+ display_price: z.string(),+ total: z.string(),+ display_total: z.string(),+ adjustment_total: z.string(),+ display_adjustment_total: z.string(),+ additional_tax_total: z.string(),+ display_additional_tax_total: z.string(),+ included_tax_total: z.string(),+ display_included_tax_total: z.string(),+ promo_total: z.string(),+ display_promo_total: z.string(),+ pre_tax_amount: z.string(),+ display_pre_tax_amount: z.string(),+ discounted_amount: z.string(),+ display_discounted_amount: z.string(),+ display_compare_at_amount: z.string().nullable(),+ created_at: z.string(),+ updated_at: z.string(),+ compare_at_amount: z.string().nullable(),+ thumbnail_url: z.string().nullable(),+ option_values: z.array(StoreOptionValueSchema),+ digital_links: z.array(StoreDigitalLinkSchema),+ metadata: z.record(z.string(), z.unknown()).nullable(),+});++export type AdminLineItem = z.infer<typeof AdminLineItemSchema>;diff --git a/packages/sdk/src/zod/generated/AdminOrder.ts b/packages/sdk/src/zod/generated/AdminOrder.tsindex 65816322ef..27c319607e 100644--- a/packages/sdk/src/zod/generated/AdminOrder.ts+++ b/packages/sdk/src/zod/generated/AdminOrder.ts@@ -1,8 +1,8 @@// This file is auto-generated. Do not edit directly.import { z } from 'zod';import { AdminCustomerSchema } from './AdminCustomer';+import { AdminLineItemSchema } from './AdminLineItem';import { StoreAddressSchema } from './StoreAddress';-import { StoreLineItemSchema } from './StoreLineItem';import { StoreOrderPromotionSchema } from './StoreOrderPromotion';import { StorePaymentSchema } from './StorePayment';import { StorePaymentMethodSchema } from './StorePaymentMethod';@@ -40,7 +40,7 @@ export const AdminOrderSchema: z.ZodObject<any> = z.object({created_at: z.string(),updated_at: z.string(),order_promotions: z.array(StoreOrderPromotionSchema),- line_items: z.array(StoreLineItemSchema),+ line_items: z.array(AdminLineItemSchema),shipments: z.array(StoreShipmentSchema),payments: z.array(StorePaymentSchema),bill_address: StoreAddressSchema.nullable(),@@ -55,6 +55,7 @@ export const AdminOrderSchema: z.ZodObject<any> = z.object({approver_id: z.string().nullable(),canceled_at: z.string().nullable(),approved_at: z.string().nullable(),+ metadata: z.record(z.string(), z.unknown()).nullable(),canceler_id: z.string().nullable(),created_by_id: z.string().nullable(),user: z.lazy(() => AdminCustomerSchema).optional(),diff --git a/packages/sdk/src/zod/generated/StorePaymentSource.ts b/packages/sdk/src/zod/generated/StorePaymentSource.tsindex 87c0e8814d..84cde5f407 100644--- a/packages/sdk/src/zod/generated/StorePaymentSource.ts+++ b/packages/sdk/src/zod/generated/StorePaymentSource.ts@@ -4,7 +4,6 @@ import { z } from 'zod';export const StorePaymentSourceSchema = z.object({id: z.string(),gateway_payment_profile_id: z.string().nullable(),- public_metadata: z.record(z.string(), z.unknown()).nullable(),});export type StorePaymentSource = z.infer<typeof StorePaymentSourceSchema>;diff --git a/packages/sdk/src/zod/generated/index.ts b/packages/sdk/src/zod/generated/index.tsindex 07aaa47f6c..abeafafa50 100644--- a/packages/sdk/src/zod/generated/index.ts+++ b/packages/sdk/src/zod/generated/index.ts@@ -1,5 +1,6 @@// This file is auto-generated. Do not edit directly.export { AdminCustomerSchema, type AdminCustomer } from './AdminCustomer';+export { AdminLineItemSchema, type AdminLineItem } from './AdminLineItem';export { AdminMetafieldSchema, type AdminMetafield } from './AdminMetafield';export { AdminOrderSchema, type AdminOrder } from './AdminOrder';export { AdminPriceSchema, type AdminPrice } from './AdminPrice';diff --git a/spree/api/app/controllers/spree/api/v3/store/cart_controller.rb b/spree/api/app/controllers/spree/api/v3/store/cart_controller.rbindex 5171871c93..b21974a9a8 100644--- a/spree/api/app/controllers/spree/api/v3/store/cart_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/cart_controller.rb@@ -15,7 +15,8 @@ module Spreeuser: current_user,store: current_store,currency: current_currency,- locale: current_locale+ locale: current_locale,+ metadata: cart_params[:metadata] || {})if result.success?@@ -59,6 +60,10 @@ module Spreeprivate+ def cart_params+ params.permit(metadata: {})+ end+# Find incomplete cart by order token for associate action# Only finds guest carts (no user) or carts already owned by current user (idempotent)def find_cart_by_tokendiff --git a/spree/api/app/controllers/spree/api/v3/store/orders/line_items_controller.rb b/spree/api/app/controllers/spree/api/v3/store/orders/line_items_controller.rbindex 1e40ffe147..617e9d0820 100644--- a/spree/api/app/controllers/spree/api/v3/store/orders/line_items_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/orders/line_items_controller.rb@@ -15,6 +15,7 @@ module Spreeorder: @parent,variant: variant,quantity: permitted_params[:quantity] || 1,+ metadata: permitted_params[:metadata] || {},options: permitted_params[:options] || {})@@ -29,6 +30,8 @@ module Spreedef update@line_item = scope.find_by_prefix_id!(params[:id])+ @line_item.metadata = @line_item.metadata.merge(permitted_params[:metadata].to_h) if permitted_params[:metadata].present?+if permitted_params[:quantity].present?result = Spree.cart_set_item_quantity_service.call(order: @parent,@@ -41,6 +44,9 @@ module Spreeelserender_service_error(result.error, code: ERROR_CODES[:invalid_quantity])end+ elsif @line_item.changed?+ @line_item.save!+ render_orderelserender_orderenddiff --git a/spree/api/app/controllers/spree/api/v3/store/orders_controller.rb b/spree/api/app/controllers/spree/api/v3/store/orders_controller.rbindex c9d84c43d5..637be5d862 100644--- a/spree/api/app/controllers/spree/api/v3/store/orders_controller.rb+++ b/spree/api/app/controllers/spree/api/v3/store/orders_controller.rb@@ -108,7 +108,8 @@ module Spree:ship_address_id,:bill_address_id,ship_address: address_params,- bill_address: address_params+ bill_address: address_params,+ metadata: {})enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/line_item_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/line_item_serializer.rbnew file mode 100644index 0000000000..3b2abc2033--- /dev/null+++ b/spree/api/app/serializers/spree/api/v3/admin/line_item_serializer.rb@@ -0,0 +1,17 @@+module Spree+ module Api+ module V3+ module Admin+ # Admin API Line Item Serializer+ # Extends the store serializer with metadata visibility+ class LineItemSerializer < V3::LineItemSerializer+ typelize metadata: 'Record<string, unknown> | null'++ attribute :metadata do |line_item|+ line_item.metadata.presence+ end+ end+ end+ end+ end+enddiff --git a/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rbindex 6415433073..117d504ab4 100644--- a/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/admin/order_serializer.rb@@ -11,7 +11,8 @@ module Spreestore_owner_notification_delivered: :boolean,internal_note: [:string, nullable: true], approver_id: [:string, nullable: true],canceler_id: [:string, nullable: true], created_by_id: [:string, nullable: true],- canceled_at: [:string, nullable: true], approved_at: [:string, nullable: true]+ canceled_at: [:string, nullable: true], approved_at: [:string, nullable: true],+ metadata: 'Record<string, unknown> | null'# Admin-only attributesattributes :channel, :last_ip_address, :considered_risky,@@ -19,6 +20,10 @@ module Spree:internal_note, :approver_id,canceled_at: :iso8601, approved_at: :iso8601+ attribute :metadata do |order|+ order.metadata.presence+ end+attribute :canceler_id do |order|order.canceler_idend@@ -27,6 +32,8 @@ module Spreeorder.created_by_idend+ many :line_items, resource: Spree.api.admin_line_item_serializer+one :user,resource: Spree.api.admin_customer_serializer,if: proc { params[:includes]&.include?('user') }diff --git a/spree/api/app/serializers/spree/api/v3/payment_source_serializer.rb b/spree/api/app/serializers/spree/api/v3/payment_source_serializer.rbindex 2fe1cf2b82..7e83c2f5a2 100644--- a/spree/api/app/serializers/spree/api/v3/payment_source_serializer.rb+++ b/spree/api/app/serializers/spree/api/v3/payment_source_serializer.rb@@ -2,16 +2,11 @@ module Spreemodule Apimodule V3class PaymentSourceSerializer < BaseSerializer- typelize gateway_payment_profile_id: [:string, nullable: true],- public_metadata: ['Record<string, unknown>', nullable: true]+ typelize gateway_payment_profile_id: [:string, nullable: true]attribute :gateway_payment_profile_id do |source|source.try(:gateway_payment_profile_id)end-- attribute :public_metadata do |source|- source.try(:public_metadata)- endendendenddiff --git a/spree/api/app/services/spree/api/v3/orders/update.rb b/spree/api/app/services/spree/api/v3/orders/update.rbindex cb7e1a5d95..e15b945feb 100644--- a/spree/api/app/services/spree/api/v3/orders/update.rb+++ b/spree/api/app/services/spree/api/v3/orders/update.rb@@ -55,6 +55,7 @@ module Spreeorder.special_instructions = params[:special_instructions] if params.key?(:special_instructions)order.currency = params[:currency].upcase if params[:currency].present?order.locale = params[:locale] if params[:locale].present?+ order.metadata = order.metadata.merge(params[:metadata].to_h) if params[:metadata].present?enddef assign_address(address_type)diff --git a/spree/api/lib/spree/api/dependencies.rb b/spree/api/lib/spree/api/dependencies.rbindex aaeda6fd33..1d62f99131 100644--- a/spree/api/lib/spree/api/dependencies.rb+++ b/spree/api/lib/spree/api/dependencies.rb@@ -156,6 +156,7 @@ module Spreeadmin_price_serializer: 'Spree::Api::V3::Admin::PriceSerializer',admin_metafield_serializer: 'Spree::Api::V3::Admin::MetafieldSerializer',admin_taxon_serializer: 'Spree::Api::V3::Admin::TaxonSerializer',+ admin_line_item_serializer: 'Spree::Api::V3::Admin::LineItemSerializer',admin_taxonomy_serializer: 'Spree::Api::V3::Admin::TaxonomySerializer',# platform serializersdiff --git a/spree/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rbindex 0818819b9f..8cc06e00fd 100644--- a/spree/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/store/cart_controller_spec.rb@@ -39,6 +39,24 @@ RSpec.describe Spree::Api::V3::Store::CartController, type: :controller doexpect(Spree::Order.last.locale).to be_presentend+ context 'with metadata' do+ it 'creates a cart with metadata' do+ post :create, params: { metadata: { 'source' => 'mobile_app', 'campaign' => 'summer_sale' } }++ expect(response).to have_http_status(:created)+ order = Spree::Order.last+ expect(order.metadata).to eq({ 'source' => 'mobile_app', 'campaign' => 'summer_sale' })+ end++ it 'does not return metadata in response' do+ post :create, params: { metadata: { 'source' => 'mobile_app' } }++ expect(response).to have_http_status(:created)+ expect(json_response).not_to have_key('metadata')+ expect(json_response).not_to have_key('private_metadata')+ end+ end+context 'for authenticated user' dobefore dorequest.headers['Authorization'] = "Bearer #{jwt_token}"diff --git a/spree/api/spec/controllers/spree/api/v3/store/orders/line_items_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/orders/line_items_controller_spec.rbindex 2cdc60656c..196e099fad 100644--- a/spree/api/spec/controllers/spree/api/v3/store/orders/line_items_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/store/orders/line_items_controller_spec.rb@@ -40,6 +40,36 @@ RSpec.describe Spree::Api::V3::Store::Orders::LineItemsController, type: :controexpect(json_response['item_total'].to_f).to be > 0end+ context 'with metadata' do+ it 'adds a line item with metadata' do+ post :create, params: {+ order_id: order.to_param,+ variant_id: variant.prefixed_id,+ quantity: 1,+ metadata: { 'gift_note' => 'Happy Birthday!' }+ }++ expect(response).to have_http_status(:created)+ line_item = order.line_items.last+ expect(line_item.metadata).to eq({ 'gift_note' => 'Happy Birthday!' })+ end++ it 'does not return metadata in response' do+ post :create, params: {+ order_id: order.to_param,+ variant_id: variant.prefixed_id,+ quantity: 1,+ metadata: { 'gift_note' => 'Happy Birthday!' }+ }++ expect(response).to have_http_status(:created)+ json_response['line_items'].each do |li|+ expect(li).not_to have_key('metadata')+ expect(li).not_to have_key('private_metadata')+ end+ end+ end+context 'with order token (guest)' dolet(:guest_order) { create(:order, user: nil, store: store) }@@ -109,6 +139,46 @@ RSpec.describe Spree::Api::V3::Store::Orders::LineItemsController, type: :controexpect(json_response['item_total'].to_f).to be > original_totalend+ context 'with metadata' do+ it 'updates line item metadata' do+ patch :update, params: {+ order_id: order.to_param,+ id: line_item.prefixed_id,+ metadata: { 'gift_note' => 'Happy Birthday!' }+ }++ expect(response).to have_http_status(:ok)+ expect(line_item.reload.metadata).to eq({ 'gift_note' => 'Happy Birthday!' })+ end++ it 'merges metadata with existing values' do+ line_item.update!(private_metadata: { 'existing_key' => 'value' })++ patch :update, params: {+ order_id: order.to_param,+ id: line_item.prefixed_id,+ metadata: { 'new_key' => 'new_value' }+ }++ expect(response).to have_http_status(:ok)+ expect(line_item.reload.metadata).to eq({ 'existing_key' => 'value', 'new_key' => 'new_value' })+ end++ it 'updates metadata and quantity together' do+ patch :update, params: {+ order_id: order.to_param,+ id: line_item.prefixed_id,+ quantity: 3,+ metadata: { 'gift_note' => 'Happy Birthday!' }+ }++ expect(response).to have_http_status(:ok)+ line_item.reload+ expect(line_item.quantity).to eq(3)+ expect(line_item.metadata).to eq({ 'gift_note' => 'Happy Birthday!' })+ end+ end+context 'error handling' doit 'returns not found for non-existent line item' dopatch :update, params: { order_id: order.to_param, id: 0, quantity: 5 }diff --git a/spree/api/spec/controllers/spree/api/v3/store/orders_controller_spec.rb b/spree/api/spec/controllers/spree/api/v3/store/orders_controller_spec.rbindex 534ae2370d..3ccadeccca 100644--- a/spree/api/spec/controllers/spree/api/v3/store/orders_controller_spec.rb+++ b/spree/api/spec/controllers/spree/api/v3/store/orders_controller_spec.rb@@ -122,6 +122,39 @@ RSpec.describe Spree::Api::V3::Store::OrdersController, type: :controller doexpect(response).to have_http_status(:unprocessable_entity)end++ it 'updates order metadata' do+ patch :update, params: {+ id: order.to_param,+ metadata: { 'source' => 'mobile_app', 'utm_campaign' => 'summer' }+ }++ expect(response).to have_http_status(:ok)+ expect(order.reload.metadata).to eq({ 'source' => 'mobile_app', 'utm_campaign' => 'summer' })+ end++ it 'merges metadata with existing values' do+ order.update!(private_metadata: { 'existing' => 'value' })++ patch :update, params: {+ id: order.to_param,+ metadata: { 'new_key' => 'new_value' }+ }++ expect(response).to have_http_status(:ok)+ expect(order.reload.metadata).to eq({ 'existing' => 'value', 'new_key' => 'new_value' })+ end++ it 'does not return metadata in response' do+ patch :update, params: {+ id: order.to_param,+ metadata: { 'source' => 'mobile_app' }+ }++ expect(response).to have_http_status(:ok)+ expect(json_response).not_to have_key('metadata')+ expect(json_response).not_to have_key('private_metadata')+ endendcontext 'with order token' dodiff --git a/spree/api/spec/integration/spree/api/v3/store/cart_spec.rb b/spree/api/spec/integration/spree/api/v3/store/cart_spec.rbindex 96361e0c26..6621d7f27d 100644--- a/spree/api/spec/integration/spree/api/v3/store/cart_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/cart_spec.rb@@ -8,6 +8,7 @@ RSpec.describe 'Cart API', type: :request, swagger_doc: 'api-reference/store.yampath '/api/v3/store/cart' dopost 'Create a new cart' dotags 'Cart'+ consumes 'application/json'produces 'application/json'security [api_key: []]description <<~DESC@@ -22,6 +23,12 @@ RSpec.describe 'Cart API', type: :request, swagger_doc: 'api-reference/store.yamparameter name: 'x-spree-api-key', in: :header, type: :string, required: trueparameter name: 'Authorization', in: :header, type: :string, required: false,description: 'Bearer JWT token (optional - for authenticated customers)'+ parameter name: :body, in: :body, required: false, schema: {+ type: :object,+ properties: {+ metadata: { type: :object, description: 'Write-only key-value metadata (Stripe-style). Not returned in responses.' }+ }+ }response '201', 'cart created (guest)' dolet(:'x-spree-api-key') { api_key.token }@@ -45,6 +52,20 @@ RSpec.describe 'Cart API', type: :request, swagger_doc: 'api-reference/store.yamrun_test!end+ response '201', 'cart created with metadata' do+ let(:'x-spree-api-key') { api_key.token }+ let(:body) { { metadata: { 'source' => 'mobile_app', 'campaign' => 'summer_sale' } } }++ schema '$ref' => '#/components/schemas/StoreOrder'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['number']).to be_present+ order = Spree::Order.find_by!(number: data['number'])+ expect(order.metadata).to eq({ 'source' => 'mobile_app', 'campaign' => 'summer_sale' })+ end+ end+response '401', 'unauthorized - invalid API key' dolet(:'x-spree-api-key') { 'invalid' }diff --git a/spree/api/spec/integration/spree/api/v3/store/line_items_spec.rb b/spree/api/spec/integration/spree/api/v3/store/line_items_spec.rbindex 5cdd350c00..f1538fc77b 100644--- a/spree/api/spec/integration/spree/api/v3/store/line_items_spec.rb+++ b/spree/api/spec/integration/spree/api/v3/store/line_items_spec.rb@@ -38,7 +38,8 @@ RSpec.describe 'Line Items API', type: :request, swagger_doc: 'api-reference/stotype: :object,properties: {variant_id: { type: :string, example: 'variant_abc123', description: 'Variant ID to add' },- quantity: { type: :integer, example: 2, description: 'Quantity to add (default: 1)' }+ quantity: { type: :integer, example: 2, description: 'Quantity to add (default: 1)' },+ metadata: { type: :object, additionalProperties: true, description: 'Arbitrary key-value metadata (stored, not returned in responses)', example: { gift_message: 'Happy Birthday!' } }},required: %w[variant_id]}@@ -60,6 +61,20 @@ RSpec.describe 'Line Items API', type: :request, swagger_doc: 'api-reference/stoendend+ response '201', 'item added with metadata' do+ let(:new_product) { create(:product, stores: [store]) }+ let(:new_variant) { new_product.master }+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:body) { { variant_id: new_variant.prefixed_id, quantity: 1, metadata: { gift_message: 'Happy Birthday!' } } }++ run_test! do |_response|+ new_line_item = order.reload.line_items.find_by(variant: new_variant)+ expect(new_line_item.metadata).to include('gift_message' => 'Happy Birthday!')+ end+ end+response '404', 'variant not found' dolet(:'x-spree-api-key') { api_key.token }let(:'Authorization') { "Bearer #{jwt_token}" }@@ -108,9 +123,9 @@ RSpec.describe 'Line Items API', type: :request, swagger_doc: 'api-reference/stoparameter name: :body, in: :body, schema: {type: :object,properties: {- quantity: { type: :integer, minimum: 1, example: 5 }- },- required: %w[quantity]+ quantity: { type: :integer, minimum: 1, example: 5 },+ metadata: { type: :object, additionalProperties: true, description: 'Arbitrary key-value metadata (merged with existing)', example: { engraving: 'J.D.' } }+ }}response '200', 'quantity updated, returns updated order' do@@ -129,6 +144,18 @@ RSpec.describe 'Line Items API', type: :request, swagger_doc: 'api-reference/stoendend+ response '200', 'metadata updated on line item' do+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:id) { line_item.to_param }+ let(:body) { { metadata: { engraving: 'J.D.' } } }++ run_test! do |_response|+ expect(line_item.reload.metadata).to include('engraving' => 'J.D.')+ end+ end+enddelete 'Remove line item from cart' dodiff --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 0032d72871..1e6ffbc66b 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@@ -114,6 +114,7 @@ RSpec.describe 'Orders API', type: :request, swagger_doc: 'api-reference/store.yemail: { type: :string, format: 'email', example: '[email protected]' },locale: { type: :string, example: 'en' },special_instructions: { type: :string, example: 'Leave at door' },+ metadata: { type: :object, additionalProperties: true, description: 'Arbitrary key-value metadata (merged with existing)', example: { source: 'mobile_app' } },bill_address: {type: :object,properties: {@@ -161,6 +162,17 @@ RSpec.describe 'Orders API', type: :request, swagger_doc: 'api-reference/store.yendend+ response '200', 'order updated with metadata' do+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:id) { order.to_param }+ let(:body) { { metadata: { source: 'mobile_app', campaign: 'summer_sale' } } }++ run_test! do |_response|+ expect(order.reload.metadata).to include('source' => 'mobile_app', 'campaign' => 'summer_sale')+ end+ end+response '403', 'cannot update completed order' dolet(:completed_order) { create(:completed_order_with_totals, store: store, user: user) }let(:'x-spree-api-key') { api_key.token }diff --git a/spree/api/spec/serializers/spree/api/v3/admin/line_item_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/admin/line_item_serializer_spec.rbnew file mode 100644index 0000000000..ce4639dad3--- /dev/null+++ b/spree/api/spec/serializers/spree/api/v3/admin/line_item_serializer_spec.rb@@ -0,0 +1,34 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::LineItemSerializer do+ let(:store) { @default_store }+ let(:order) { create(:order, store: store) }+ let(:line_item) { create(:line_item, order: order) }+ let(:base_params) { { store: store, currency: 'USD' } }++ subject { described_class.new(line_item, params: base_params).to_h }++ describe 'metadata' do+ context 'when line item has metadata' do+ before { line_item.update!(private_metadata: { 'gift_note' => 'Happy Birthday!', 'engraving' => 'J.D.' }) }++ it 'returns the metadata' do+ expect(subject['metadata']).to eq({ 'gift_note' => 'Happy Birthday!', 'engraving' => 'J.D.' })+ end+ end++ context 'when line item has no metadata' do+ it 'returns nil' do+ expect(subject['metadata']).to be_nil+ end+ end+ end++ it 'inherits all store line item attributes' do+ expect(subject).to have_key('id')+ expect(subject).to have_key('variant_id')+ expect(subject).to have_key('quantity')+ expect(subject).to have_key('price')+ expect(subject).to have_key('total')+ end+enddiff --git a/spree/api/spec/serializers/spree/api/v3/admin/order_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/admin/order_serializer_spec.rbnew file mode 100644index 0000000000..825dc033cf--- /dev/null+++ b/spree/api/spec/serializers/spree/api/v3/admin/order_serializer_spec.rb@@ -0,0 +1,37 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Admin::OrderSerializer do+ let(:store) { @default_store }+ let(:order) { create(:order, store: store) }+ let(:base_params) { { store: store, currency: store.default_currency } }++ subject { described_class.new(order, params: base_params).to_h }++ describe 'metadata' do+ context 'when order has metadata' do+ before { order.update!(private_metadata: { 'source' => 'mobile_app', 'campaign' => 'summer' }) }++ it 'returns the metadata' do+ expect(subject['metadata']).to eq({ 'source' => 'mobile_app', 'campaign' => 'summer' })+ end+ end++ context 'when order has no metadata' do+ it 'returns nil' do+ expect(subject['metadata']).to be_nil+ end+ end+ end++ describe 'line_items' do+ let(:order) { create(:order_with_line_items, store: store) }++ before { order.line_items.first.update!(private_metadata: { 'gift' => true }) }++ it 'uses admin line item serializer with metadata' do+ line_item_data = subject['line_items'].first+ expect(line_item_data).to have_key('metadata')+ expect(line_item_data['metadata']).to eq({ 'gift' => true })+ end+ end+enddiff --git a/spree/api/spec/serializers/spree/api/v3/line_item_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/line_item_serializer_spec.rbindex 430c6b211e..b472b9b5f1 100644--- a/spree/api/spec/serializers/spree/api/v3/line_item_serializer_spec.rb+++ b/spree/api/spec/serializers/spree/api/v3/line_item_serializer_spec.rb@@ -90,6 +90,12 @@ RSpec.describe Spree::Api::V3::LineItemSerializer doendend+ it 'does not expose metadata in Store API responses' do+ line_item.update!(private_metadata: { 'gift_note' => 'Happy Birthday!' })+ expect(subject).not_to have_key('metadata')+ expect(subject).not_to have_key('private_metadata')+ end+describe 'compare_at_amount' docontext 'when variant has no compare_at_price' doit 'returns nil' dodiff --git a/spree/api/spec/serializers/spree/api/v3/payment_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/payment_serializer_spec.rbindex 4623c22919..ed4d3f85b0 100644--- a/spree/api/spec/serializers/spree/api/v3/payment_serializer_spec.rb+++ b/spree/api/spec/serializers/spree/api/v3/payment_serializer_spec.rb@@ -76,7 +76,7 @@ RSpec.describe Spree::Api::V3::PaymentSerializer doexpect(subject['source']).to be_a(Hash)expect(subject['source']['id']).to eq(payment.source.prefixed_id)expect(subject['source']).to have_key('gateway_payment_profile_id')- expect(subject['source']).to have_key('public_metadata')+ expect(subject['source']).not_to have_key('public_metadata')endenddiff --git a/spree/api/spec/serializers/spree/api/v3/payment_source_serializer_spec.rb b/spree/api/spec/serializers/spree/api/v3/payment_source_serializer_spec.rbindex de386024f6..472ef13dfd 100644--- a/spree/api/spec/serializers/spree/api/v3/payment_source_serializer_spec.rb+++ b/spree/api/spec/serializers/spree/api/v3/payment_source_serializer_spec.rb@@ -14,7 +14,7 @@ RSpec.describe Spree::Api::V3::PaymentSourceSerializer doit 'includes all expected attributes' doexpect(subject.keys).to match_array(%w[- id gateway_payment_profile_id public_metadata+ id gateway_payment_profile_id])end@@ -34,17 +34,9 @@ RSpec.describe Spree::Api::V3::PaymentSourceSerializer doendend- context 'with public_metadata' do- before { payment_source.update!(public_metadata: { 'email' => '[email protected]' }) }-- it 'returns the public_metadata' do- expect(subject['public_metadata']).to eq({ 'email' => '[email protected]' })- end- end-- context 'without public_metadata' do- it 'returns nil or empty for public_metadata' do- expect(subject['public_metadata']).to be_blank- end+ it 'does not expose metadata in Store API responses' do+ payment_source.update!(public_metadata: { 'email' => '[email protected]' })+ expect(subject).not_to have_key('public_metadata')+ expect(subject).not_to have_key('metadata')endenddiff --git a/spree/api/spec/services/spree/api/v3/orders/update_spec.rb b/spree/api/spec/services/spree/api/v3/orders/update_spec.rbindex 26f338bac0..8beb00488b 100644--- a/spree/api/spec/services/spree/api/v3/orders/update_spec.rb+++ b/spree/api/spec/services/spree/api/v3/orders/update_spec.rb@@ -200,6 +200,26 @@ RSpec.describe Spree::Api::V3::Orders::Update doendend+ describe 'updating metadata' do+ let(:params) { { metadata: { 'erp_id' => '12345', 'source' => 'mobile' } } }++ it 'merges metadata into the order' do+ expect(subject).to be_success+ expect(order.reload.metadata).to include('erp_id' => '12345', 'source' => 'mobile')+ end++ context 'with existing metadata' do+ before { order.update!(metadata: { 'existing_key' => 'existing_value' }) }++ let(:params) { { metadata: { 'new_key' => 'new_value' } } }++ it 'merges without removing existing keys' do+ expect(subject).to be_success+ expect(order.reload.metadata).to include('existing_key' => 'existing_value', 'new_key' => 'new_value')+ end+ end+ end+describe 'updating multiple fields' dolet(:country) { Spree::Country.find_by(iso: 'US') || create(:country, iso: 'US') }let!(:state) { country.states.find_by(abbr: 'NY') || create(:state, country: country, abbr: 'NY', name: 'New York') }diff --git a/spree/core/app/models/concerns/spree/metadata.rb b/spree/core/app/models/concerns/spree/metadata.rbindex aa4feb2027..95772ec926 100644--- a/spree/core/app/models/concerns/spree/metadata.rb+++ b/spree/core/app/models/concerns/spree/metadata.rb@@ -12,6 +12,16 @@ module Spreeserialize :private_metadata, coder: HashSerializerend+ # `metadata` is the primary API-facing accessor.+ # It maps to `private_metadata` under the hood (Stripe-style: write-only, never returned in Store API).+ def metadata+ private_metadata+ end++ def metadata=(value)+ self.private_metadata = value+ end+# https://nandovieira.com/using-postgresql-and-jsonb-with-ruby-on-railsclass HashSerializerdef self.dump(hash)diff --git a/spree/core/app/services/spree/cart/add_item.rb b/spree/core/app/services/spree/cart/add_item.rbindex c2e4ec42c0..86ebc137ed 100644--- a/spree/core/app/services/spree/cart/add_item.rb+++ b/spree/core/app/services/spree/cart/add_item.rb@@ -3,7 +3,7 @@ module Spreeclass AddItemprepend Spree::ServiceModule::Base- def call(order:, variant:, quantity: nil, public_metadata: {}, private_metadata: {}, options: {})+ def call(order:, variant:, quantity: nil, metadata: {}, public_metadata: {}, private_metadata: {}, options: {})ApplicationRecord.transaction dorun :add_to_line_itemrun Spree.cart_recalculate_service@@ -12,7 +12,7 @@ module Spreeprivate- def add_to_line_item(order:, variant:, quantity: nil, public_metadata: {}, private_metadata: {}, options: {})+ def add_to_line_item(order:, variant:, quantity: nil, metadata: {}, public_metadata: {}, private_metadata: {}, options: {})options ||= {}quantity ||= 1@@ -34,8 +34,12 @@ module Spreeendline_item.target_shipment = options[:shipment] if options.key? :shipment- line_item.public_metadata = public_metadata.to_h if public_metadata- line_item.private_metadata = private_metadata.to_h if private_metadata++ # `metadata` is the primary API param (maps to private_metadata).+ # Legacy `public_metadata`/`private_metadata` params kept for backward compatibility.+ resolved_metadata = metadata.presence || private_metadata+ line_item.metadata = resolved_metadata.to_h if resolved_metadata.present?+ line_item.public_metadata = public_metadata.to_h if public_metadata.present?return failure(line_item) unless line_item.savediff --git a/spree/core/app/services/spree/cart/create.rb b/spree/core/app/services/spree/cart/create.rbindex a54c7eccc7..8c145d3dd2 100644--- a/spree/core/app/services/spree/cart/create.rb+++ b/spree/core/app/services/spree/cart/create.rb@@ -11,19 +11,21 @@ module Spree# @param private_metadata [Hash] private metadata for the order# @param order_params [Hash] additional order attributes# @return [Spree::ServiceModule::Result]- def call(user:, store:, currency:, locale: nil, public_metadata: {}, private_metadata: {}, order_params: {})+ def call(user:, store:, currency:, locale: nil, metadata: {}, public_metadata: {}, private_metadata: {}, order_params: {})order_params ||= {}# we cannot create an order without storereturn failure(:store_is_required) if store.nil?+ resolved_metadata = metadata.presence || private_metadata+default_params = {user: user,currency: currency || store.default_currency,locale: locale || Spree::Current.locale,token: Spree::GenerateToken.new.call(Spree::Order),public_metadata: public_metadata.to_h,- private_metadata: private_metadata.to_h+ private_metadata: resolved_metadata.to_h}order = store.orders.create!(default_params.merge(order_params))diff --git a/spree/core/lib/spree/permitted_attributes.rb b/spree/core/lib/spree/permitted_attributes.rbindex dd9e147919..fc4e962d03 100644--- a/spree/core/lib/spree/permitted_attributes.rb+++ b/spree/core/lib/spree/permitted_attributes.rb@@ -140,7 +140,7 @@ module Spree@@invitation_attributes = [:email, :expires_at, :role_id]- @@line_item_attributes = [:id, :variant_id, :quantity]+ @@line_item_attributes = [:id, :variant_id, :quantity, { metadata: {} }]@@market_attributes = [:name, :currency, :default_locale, :supported_locales,:tax_inclusive, :default, :position, country_ids: []]diff --git a/spree/core/spec/models/spree/concerns/metadata_spec.rb b/spree/core/spec/models/spree/concerns/metadata_spec.rbnew file mode 100644index 0000000000..bbf79a48f2--- /dev/null+++ b/spree/core/spec/models/spree/concerns/metadata_spec.rb@@ -0,0 +1,27 @@+require 'spec_helper'++RSpec.describe Spree::Metadata do+ let(:product) { build(:product) }++ describe '#metadata' do+ it 'reads from private_metadata' do+ product.private_metadata = { 'key' => 'value' }+ expect(product.metadata).to eq('key' => 'value')+ end+ end++ describe '#metadata=' do+ it 'writes to private_metadata' do+ product.metadata = { 'key' => 'value' }+ expect(product.private_metadata).to eq('key' => 'value')+ end+ end++ describe 'merge semantics' do+ it 'supports merging metadata' do+ product.metadata = { 'a' => '1' }+ product.metadata = product.metadata.merge('b' => '2')+ expect(product.metadata).to eq('a' => '1', 'b' => '2')+ end+ end+enddiff --git a/spree/core/spec/services/spree/cart/add_item_spec.rb b/spree/core/spec/services/spree/cart/add_item_spec.rbindex 77fb590340..9a22287f6c 100644--- a/spree/core/spec/services/spree/cart/add_item_spec.rb+++ b/spree/core/spec/services/spree/cart/add_item_spec.rb@@ -213,20 +213,30 @@ module Spreeendcontext 'setting metadata' do- let(:public_metadata) { {'prop1' => 'value1'} }- let(:private_metadata) { {'prop2' => 'value2'} }- let(:execute) { subject.call(order: order, variant: variant, quantity: qty, public_metadata: public_metadata, private_metadata: private_metadata) }+ context 'via metadata param' do+ let(:metadata) { { 'gift_message' => 'Happy Birthday!' } }+ let(:execute) { subject.call(order: order, variant: variant, quantity: qty, metadata: metadata) }- context 'private metadata' do- it do+ it 'stores metadata on the line item' doexpect(execute).to be_successorder.reload- expect(order.line_items.first.private_metadata).to eq private_metadata+ expect(order.line_items.first.metadata).to eq metadata+ expect(order.line_items.first.private_metadata).to eq metadataendend- context 'public metadata' do- it do+ context 'via legacy public_metadata and private_metadata params' do+ let(:public_metadata) { { 'prop1' => 'value1' } }+ let(:private_metadata) { { 'prop2' => 'value2' } }+ let(:execute) { subject.call(order: order, variant: variant, quantity: qty, public_metadata: public_metadata, private_metadata: private_metadata) }++ it 'stores private_metadata' do+ expect(execute).to be_success+ order.reload+ expect(order.line_items.first.private_metadata).to eq private_metadata+ end++ it 'stores public_metadata' doexpect(execute).to be_successorder.reloadexpect(order.line_items.first.public_metadata).to eq public_metadata