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
Add comprehensive coupon codes and gift card API specs (#13582)
Damian Legawiec3264eae572a9
diff --git a/backend/engines/api/app/controllers/spree/api/v3/store/orders/coupon_codes_controller.rb b/backend/engines/api/app/controllers/spree/api/v3/store/orders/coupon_codes_controller.rbindex b82dab703a..2c23167bea 100644--- a/backend/engines/api/app/controllers/spree/api/v3/store/orders/coupon_codes_controller.rb+++ b/backend/engines/api/app/controllers/spree/api/v3/store/orders/coupon_codes_controller.rb@@ -7,7 +7,7 @@ module Spreeinclude Spree::Api::V3::OrderConcernbefore_action :authorize_order_access!- skip_before_action :set_resource, only: [:create]+ skip_before_action :set_resource# POST /api/v3/store/orders/:order_id/coupon_codes# Apply a coupon code to the order@@ -27,6 +27,7 @@ module Spree# Remove a coupon code from the order# :id is the promotion prefix_id (e.g., promo_xxx)def destroy+ @resource = scope.find_by_prefix_id!(params[:id])coupon_code = @resource.code.presence || @resource.namecoupon_handler.remove(coupon_code)@@ -61,7 +62,7 @@ module Spreeenddef order_serializer- Spree.api.order_serializer.constantize+ Spree.api.order_serializerendendenddiff --git a/backend/engines/api/spec/controllers/spree/api/v3/store/orders/coupon_codes_controller_spec.rb b/backend/engines/api/spec/controllers/spree/api/v3/store/orders/coupon_codes_controller_spec.rbnew file mode 100644index 0000000000..45b14b660a--- /dev/null+++ b/backend/engines/api/spec/controllers/spree/api/v3/store/orders/coupon_codes_controller_spec.rb@@ -0,0 +1,167 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::Store::Orders::CouponCodesController, type: :controller do+ render_views++ include_context 'API v3 Store'++ let!(:order) { create(:order_with_line_items, store: store, user: user) }++ before do+ request.headers['X-Spree-Api-Key'] = api_key.token+ request.headers['Authorization'] = "Bearer #{jwt_token}"+ request.headers['x-spree-order-token'] = order.token+ end++ describe 'POST #create' do+ context 'with a standard promotion (single code)' do+ let!(:promotion) { create(:promotion_with_item_adjustment, code: 'SAVE10', stores: [store]) }++ it 'applies the coupon code successfully' do+ post :create, params: { order_id: order.to_param, code: 'SAVE10' }++ expect(response).to have_http_status(:created)+ expect(json_response['number']).to eq(order.number)+ end++ it 'is case insensitive' do+ post :create, params: { order_id: order.to_param, code: 'save10' }++ expect(response).to have_http_status(:created)+ end++ it 'returns error for invalid coupon code' do+ post :create, params: { order_id: order.to_param, code: 'INVALID' }++ expect(response).to have_http_status(:unprocessable_entity)+ expect(json_response['error']).to be_present+ end++ it 'returns error when coupon is already applied' do+ order.coupon_code = 'SAVE10'+ Spree::PromotionHandler::Coupon.new(order).apply++ post :create, params: { order_id: order.to_param, code: 'SAVE10' }++ expect(response).to have_http_status(:unprocessable_entity)+ end+ end++ context 'with a multi-code promotion' do+ let!(:promotion) do+ create(:promotion, :with_line_item_adjustment, multi_codes: true, number_of_codes: 1, stores: [store])+ end+ let!(:coupon_code) { create(:coupon_code, promotion: promotion, code: 'multi1') }++ it 'applies the multi-code coupon successfully' do+ post :create, params: { order_id: order.to_param, code: 'multi1' }++ expect(response).to have_http_status(:created)+ expect(json_response['number']).to eq(order.number)+ end++ it 'marks the coupon code as used' do+ post :create, params: { order_id: order.to_param, code: 'multi1' }++ expect(coupon_code.reload.state).to eq('used')+ end+ end++ context 'with a gift card' do+ let!(:gift_card) { create(:gift_card, store: store, amount: 50, code: 'giftcard123') }++ it 'applies the gift card successfully' do+ post :create, params: { order_id: order.to_param, code: 'giftcard123' }++ expect(response).to have_http_status(:created)+ expect(json_response['number']).to eq(order.number)+ end++ it 'returns error for expired gift card' do+ gift_card.update!(expires_at: 1.day.ago)++ post :create, params: { order_id: order.to_param, code: 'giftcard123' }++ expect(response).to have_http_status(:unprocessable_entity)+ end++ it 'returns error for redeemed gift card' do+ gift_card.update!(state: :redeemed, redeemed_at: Time.current, amount_used: gift_card.amount)++ post :create, params: { order_id: order.to_param, code: 'giftcard123' }++ expect(response).to have_http_status(:unprocessable_entity)+ end+ end++ context 'with expired promotion' do+ let!(:promotion) do+ create(:promotion_with_item_adjustment, code: 'EXPIRED', stores: [store],+ starts_at: 1.month.ago, expires_at: 1.day.ago)+ end++ it 'returns error' do+ post :create, params: { order_id: order.to_param, code: 'EXPIRED' }++ expect(response).to have_http_status(:unprocessable_entity)+ end+ end++ context 'without order access' do+ let(:other_order) { create(:order, store: store) }++ it 'returns forbidden' do+ request.headers['x-spree-order-token'] = nil+ post :create, params: { order_id: other_order.to_param, code: 'SAVE10' }++ expect(response).to have_http_status(:forbidden)+ end+ end++ context 'with guest order token' do+ let(:guest_order) { create(:order_with_line_items, store: store, user: nil) }+ let!(:promotion) { create(:promotion_with_item_adjustment, code: 'GUEST10', stores: [store]) }++ before do+ request.headers['Authorization'] = nil+ request.headers['x-spree-order-token'] = guest_order.token+ end++ it 'allows access via order token' do+ post :create, params: { order_id: guest_order.to_param, code: 'GUEST10' }++ expect(response).to have_http_status(:created)+ end+ end+ end++ describe 'DELETE #destroy' do+ context 'with a standard promotion' do+ let!(:promotion) { create(:promotion_with_item_adjustment, code: 'REMOVE10', stores: [store]) }++ before do+ order.coupon_code = 'REMOVE10'+ Spree::PromotionHandler::Coupon.new(order).apply+ end++ it 'removes the coupon code successfully' do+ order_promotion = order.order_promotions.find_by(promotion: promotion)+ # OrderPromotion lacks has_prefix_id, so construct a decodable param+ encoded_id = "op_#{Spree::PrefixedId::SQIDS.encode([order_promotion.id])}"++ delete :destroy, params: { order_id: order.to_param, id: encoded_id }++ expect(response).to have_http_status(:ok)+ expect(order.reload.promotions).not_to include(promotion)+ end+ end++ context 'with non-existent promotion' do+ it 'returns not found' do+ delete :destroy, params: { order_id: order.to_param, id: 'op_nonexistent' }++ expect(response).to have_http_status(:not_found)+ end+ end+ end+enddiff --git a/backend/engines/api/spec/integration/spree/api/v3/store/coupon_codes_spec.rb b/backend/engines/api/spec/integration/spree/api/v3/store/coupon_codes_spec.rbnew file mode 100644index 0000000000..4a056ab14e--- /dev/null+++ b/backend/engines/api/spec/integration/spree/api/v3/store/coupon_codes_spec.rb@@ -0,0 +1,142 @@+# frozen_string_literal: true++require 'swagger_helper'++RSpec.describe 'Coupon Codes API', type: :request, swagger_doc: 'api-reference/store.yaml' do+ include_context 'API v3 Store'++ let!(:order) { create(:order_with_line_items, store: store, user: user) }++ path '/api/v3/store/orders/{order_id}/coupon_codes' do+ post 'Apply coupon code' do+ tags 'Coupon Codes'+ consumes 'application/json'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description <<~DESC+ Applies a coupon code to the order. Supports both promotion coupon codes and gift card codes.+ The code is matched case-insensitively.+ DESC++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: 'Authorization', in: :header, type: :string, required: false,+ description: 'Bearer token for authenticated customers'+ parameter name: :order_id, in: :path, type: :string, required: true,+ description: 'Order ID'+ parameter name: :order_token, in: :query, type: :string, required: false,+ description: 'Order token for guest access'+ parameter name: :body, in: :body, schema: {+ type: :object,+ properties: {+ code: { type: :string, example: 'SAVE10', description: 'Coupon code or gift card code to apply' }+ },+ required: %w[code]+ }++ response '201', 'coupon code applied (promotion)' do+ let!(:promotion) { create(:promotion_with_item_adjustment, code: 'SAVE10', stores: [store]) }+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:body) { { code: 'SAVE10' } }++ schema '$ref' => '#/components/schemas/StoreOrder'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['number']).to eq(order.number)+ end+ end++ response '201', 'coupon code applied (gift card)' do+ let!(:gift_card) { create(:gift_card, store: store, amount: 50, code: 'giftcode1') }+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:body) { { code: 'giftcode1' } }++ schema '$ref' => '#/components/schemas/StoreOrder'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['number']).to eq(order.number)+ end+ end++ response '422', 'invalid coupon code' do+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:body) { { code: 'NONEXISTENT' } }++ schema '$ref' => '#/components/schemas/ErrorResponse'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['error']).to be_present+ end+ end++ response '404', 'order not found' do+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { 'or_nonexistent' }+ let(:body) { { code: 'SAVE10' } }++ schema '$ref' => '#/components/schemas/ErrorResponse'++ run_test!+ end+ end+ end++ path '/api/v3/store/orders/{order_id}/coupon_codes/{id}' do+ delete 'Remove coupon code' do+ tags 'Coupon Codes'+ produces 'application/json'+ security [api_key: [], bearer_auth: []]+ description 'Removes a previously applied coupon code from the order.'++ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true+ parameter name: 'Authorization', in: :header, type: :string, required: false,+ description: 'Bearer token for authenticated customers'+ parameter name: :order_id, in: :path, type: :string, required: true,+ description: 'Order ID'+ parameter name: :id, in: :path, type: :string, required: true,+ description: 'Order promotion ID'+ parameter name: :order_token, in: :query, type: :string, required: false,+ description: 'Order token for guest access'++ response '200', 'coupon code removed' do+ let!(:promotion) { create(:promotion_with_item_adjustment, code: 'REMOVE10', stores: [store]) }+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:id) do+ order.coupon_code = 'REMOVE10'+ Spree::PromotionHandler::Coupon.new(order).apply+ op = order.order_promotions.find_by(promotion: promotion)+ "op_#{Spree::PrefixedId::SQIDS.encode([op.id])}"+ end++ schema '$ref' => '#/components/schemas/StoreOrder'++ run_test! do |response|+ data = JSON.parse(response.body)+ expect(data['number']).to eq(order.number)+ end+ end++ response '404', 'coupon code not found on order' do+ let(:'x-spree-api-key') { api_key.token }+ let(:'Authorization') { "Bearer #{jwt_token}" }+ let(:order_id) { order.to_param }+ let(:id) { 'op_nonexistent' }++ schema '$ref' => '#/components/schemas/ErrorResponse'++ run_test!+ end+ end+ end+enddiff --git a/backend/engines/api/spec/serializers/spree/api/v3/gift_card_serializer_spec.rb b/backend/engines/api/spec/serializers/spree/api/v3/gift_card_serializer_spec.rbnew file mode 100644index 0000000000..2b8e4fba06--- /dev/null+++ b/backend/engines/api/spec/serializers/spree/api/v3/gift_card_serializer_spec.rb@@ -0,0 +1,105 @@+require 'spec_helper'++RSpec.describe Spree::Api::V3::GiftCardSerializer do+ let(:store) { @default_store }+ let(:gift_card) { create(:gift_card, store: store, amount: 100, amount_used: 25) }+ let(:base_params) { { store: store, currency: store.default_currency } }++ subject { described_class.new(gift_card, params: base_params).to_h }++ it 'includes all expected attributes' do+ expect(subject.keys).to match_array(%w[+ id code state currency+ amount amount_used amount_authorized amount_remaining+ display_amount display_amount_used display_amount_remaining+ expires_at redeemed_at expired active+ created_at updated_at+ ])+ end++ it 'returns the prefixed id' do+ expect(subject['id']).to eq(gift_card.prefixed_id)+ end++ it 'returns the uppercased code' do+ expect(subject['code']).to eq(gift_card.code.upcase)+ end++ it 'returns correct amounts as floats' do+ expect(subject['amount']).to eq(100.0)+ expect(subject['amount_used']).to eq(25.0)+ expect(subject['amount_authorized']).to eq(0.0)+ expect(subject['amount_remaining']).to eq(75.0)+ end++ it 'returns display amounts as strings' do+ expect(subject['display_amount']).to be_a(String)+ expect(subject['display_amount_used']).to be_a(String)+ expect(subject['display_amount_remaining']).to be_a(String)+ end++ it 'returns currency' do+ expect(subject['currency']).to eq(gift_card.currency)+ end++ it 'returns state' do+ expect(subject['state']).to eq('active')+ end++ it 'returns active as true for active card' do+ expect(subject['active']).to be true+ expect(subject['expired']).to be false+ end++ it 'returns nil for expires_at and redeemed_at when not set' do+ expect(subject['expires_at']).to be_nil+ expect(subject['redeemed_at']).to be_nil+ end++ it 'returns ISO 8601 timestamps' do+ expect(subject['created_at']).to be_present+ expect(subject['updated_at']).to be_present+ end++ context 'with expired gift card' do+ let(:gift_card) { create(:gift_card, :expired, store: store, amount: 50) }++ it 'returns expired state' do+ expect(subject['state']).to eq('expired')+ expect(subject['expired']).to be true+ expect(subject['active']).to be false+ end++ it 'returns expires_at as ISO 8601' do+ expect(subject['expires_at']).to eq(gift_card.expires_at.iso8601)+ end+ end++ context 'with redeemed gift card' do+ let(:gift_card) { create(:gift_card, :redeemed, store: store, amount: 50) }++ it 'returns redeemed state' do+ expect(subject['state']).to eq('redeemed')+ end++ it 'returns redeemed_at as ISO 8601' do+ expect(subject['redeemed_at']).to eq(gift_card.redeemed_at.iso8601)+ end++ it 'returns zero remaining amount' do+ expect(subject['amount_remaining']).to eq(0.0)+ end+ end++ context 'with partially redeemed gift card' do+ let(:gift_card) { create(:gift_card, store: store, state: :partially_redeemed, amount: 100, amount_used: 40) }++ it 'returns partially_redeemed state' do+ expect(subject['state']).to eq('partially_redeemed')+ end++ it 'returns correct remaining amount' do+ expect(subject['amount_remaining']).to eq(60.0)+ end+ end+enddiff --git a/backend/engines/api/spec/swagger_helper.rb b/backend/engines/api/spec/swagger_helper.rbindex 885eebc404..f5953454c0 100644--- a/backend/engines/api/spec/swagger_helper.rb+++ b/backend/engines/api/spec/swagger_helper.rb@@ -89,8 +89,10 @@ RSpec.configure do |config|{ name: 'Taxonomies', description: 'Category hierarchies' },{ name: 'Taxons', description: 'Individual categories' },{ name: 'Countries', description: 'Available shipping countries' },- { name: 'Orders', description: 'Shopping cart and checkout' },+ { name: 'Cart', description: 'Shopping cart management' },+ { name: 'Orders', description: 'Order management and checkout' },{ name: 'Line Items', description: 'Cart item management' },+ { name: 'Coupon Codes', description: 'Coupon code and gift card management' },{ name: 'Payments', description: 'Payment processing' },{ name: 'Payment Methods', description: 'Available payment options' },{ name: 'Shipments', description: 'Shipping and delivery' },@@ -100,6 +102,12 @@ RSpec.configure do |config|{ name: 'Wishlists', description: 'Customer wishlists' },{ name: 'Digitals', description: 'Digital product downloads' }],+ 'x-tagGroups': [+ { name: 'Store', tags: %w[Store Countries] },+ { name: 'Catalog', tags: %w[Products Taxonomies Taxons] },+ { name: 'Checkout', tags: ['Cart', 'Orders', 'Line Items', 'Coupon Codes', 'Payments', 'Payment Methods', 'Shipments'] },+ { name: 'Customer', tags: ['Authentication', 'Customers', 'Addresses', 'Credit Cards', 'Wishlists', 'Digitals'] }+ ],components: {securitySchemes: {api_key: {diff --git a/docs/api-reference/store.yaml b/docs/api-reference/store.yamlindex dd74ec16e3..f6f24d3092 100644--- a/docs/api-reference/store.yaml+++ b/docs/api-reference/store.yaml@@ -446,14 +446,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MTAwNTI5OX0.fAC8cQFs7snJb1g5ewExxmk7fovtC1FV66jl7ymhWek+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MTA3MTIyNH0.HmD2UOvxWIighCsiq3Xah1A_LnAThQu4bCpfDWe9GJ8user:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Danae- last_name: Romaguera- created_at: '2026-02-12T17:54:59.230Z'- updated_at: '2026-02-12T17:54:59.230Z'+ first_name: Lauran+ last_name: Runolfsdottir+ created_at: '2026-02-13T12:13:44.002Z'+ updated_at: '2026-02-13T12:13:44.002Z'addresses: []default_billing_address:default_shipping_address:@@ -509,14 +509,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MTAwNTMwMH0.ISFQmvLc2r9hFTjRPbMHddagLqw9ZbWvyXkdA7DkvkU+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MTA3MTIyNX0.D_DjQzm7dQl0RCwSuuySCQRkhBxsbY3BMqS0U5_bIKouser:id: cus_UkLWZg9DAJemail: [email protected]first_name: Johnlast_name: Doe- created_at: '2026-02-12T17:55:00.792Z'- updated_at: '2026-02-12T17:55:00.792Z'+ created_at: '2026-02-13T12:13:45.532Z'+ updated_at: '2026-02-13T12:13:45.532Z'addresses: []default_billing_address:default_shipping_address:@@ -588,14 +588,14 @@ paths:content:application/json:example:- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MTAwNTMwMX0._5B5LO1C501-_yTECYX0vAjipXzrDdvrdpiX4AFiJ5s+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJjdXN0b21lciIsImV4cCI6MTc3MTA3MTIyN30.toq3J9eKObvvAhSudYrDoWcZSnHKe57hgrbMkoSVSzAuser:id: cus_UkLWZg9DAJemail: [email protected]- first_name: Charlsie- last_name: Conn- created_at: '2026-02-12T17:55:01.705Z'- updated_at: '2026-02-12T17:55:01.705Z'+ first_name: Charolette+ last_name: Harris+ created_at: '2026-02-13T12:13:47.171Z'+ updated_at: '2026-02-13T12:13:47.171Z'addresses: []default_billing_address:default_shipping_address:@@ -647,10 +647,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R652207583+ number: R407115412state: cart- token: hwjUhvcQv9fcFzyz9veW2n76ftgEoDG5JV4- email: [email protected]+ token: j9ETZ7Ezto3fnRCfJyPvQPzsYAuFCUXajAm+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -673,14 +673,14 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:02.850Z'- updated_at: '2026-02-12T17:55:02.993Z'+ created_at: '2026-02-13T12:13:48.389Z'+ updated_at: '2026-02-13T12:13:48.581Z'line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1- name: Product 25569- slug: product-25569+ name: Product 22564+ slug: product-22564options_text: ''price: '10.0'display_price: "$10.00"@@ -699,8 +699,8 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-12T17:55:02.932Z'- updated_at: '2026-02-12T17:55:02.932Z'+ created_at: '2026-02-13T12:13:48.494Z'+ updated_at: '2026-02-13T12:13:48.494Z'compare_at_amount:thumbnail_url:option_values: []@@ -766,10 +766,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R450103523+ number: R580854169state: cart- token: rqJEpG4dWKJKEx86B4m69sbym7YWKWApZ7R- email: [email protected]+ token: ipHzSLCLbedVwkMCkqpmWTc2Y9qe2QBmHqa+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -792,14 +792,14 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:03.018Z'- updated_at: '2026-02-12T17:55:03.168Z'+ created_at: '2026-02-13T12:13:48.623Z'+ updated_at: '2026-02-13T12:13:48.847Z'line_items:- id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 1- name: Product 35104- slug: product-35104+ name: Product 35893+ slug: product-35893options_text: ''price: '10.0'display_price: "$10.00"@@ -818,8 +818,8 @@ paths:discounted_amount: '10.0'display_discounted_amount: "$10.00"display_compare_at_amount: "$0.00"- created_at: '2026-02-12T17:55:03.105Z'- updated_at: '2026-02-12T17:55:03.105Z'+ created_at: '2026-02-13T12:13:48.779Z'+ updated_at: '2026-02-13T12:13:48.779Z'compare_at_amount:thumbnail_url:option_values: []@@ -1029,6 +1029,202 @@ paths:message: Country not foundschema:"$ref": "#/components/schemas/ErrorResponse"+ "/api/v3/store/orders/{order_id}/coupon_codes":+ post:+ summary: Apply coupon code+ tags:+ - Coupon Codes+ security:+ - api_key: []+ bearer_auth: []+ description: |+ Applies a coupon code to the order. Supports both promotion coupon codes and gift card codes.+ The code is matched case-insensitively.+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: false+ description: Bearer token for authenticated customers+ schema:+ type: string+ - name: order_id+ in: path+ required: true+ description: Order ID+ schema:+ type: string+ - name: order_token+ in: query+ required: false+ description: Order token for guest access+ schema:+ type: string+ responses:+ '201':+ description: coupon code applied (gift card)+ content:+ application/json:+ example:+ id: or_UkLWZg9DAJ+ number: R965146507+ state: cart+ token: sUnjmNM8rgSLfJ2wSQBTy8Yet8Qv11qfyca+ email: [email protected]+ special_instructions:+ currency: USD+ item_count: 1+ shipment_state:+ payment_state:+ item_total: '10.0'+ display_item_total: "$10.00"+ ship_total: '100.0'+ display_ship_total: "$100.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ promo_total: '0.0'+ display_promo_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '110.0'+ display_total: "$110.00"+ completed_at:+ created_at: '2026-02-13T12:13:53.913Z'+ updated_at: '2026-02-13T12:13:54.130Z'+ payment_methods:+ - id: pm_UkLWZg9DAJ+ name: Store Credit+ description:+ type: Spree::PaymentMethod::StoreCredit+ schema:+ "$ref": "#/components/schemas/StoreOrder"+ '422':+ description: invalid coupon code+ content:+ application/json:+ example:+ error:+ code: processing_error+ message: The coupon code you entered doesn't exist. Please try again.+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ '404':+ description: order not found+ content:+ application/json:+ example:+ error:+ code: order_not_found+ message: Order not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse"+ requestBody:+ content:+ application/json:+ schema:+ type: object+ properties:+ code:+ type: string+ example: SAVE10+ description: Coupon code or gift card code to apply+ required:+ - code+ "/api/v3/store/orders/{order_id}/coupon_codes/{id}":+ delete:+ summary: Remove coupon code+ tags:+ - Coupon Codes+ security:+ - api_key: []+ bearer_auth: []+ description: Removes a previously applied coupon code from the order.+ parameters:+ - name: x-spree-api-key+ in: header+ required: true+ schema:+ type: string+ - name: Authorization+ in: header+ required: false+ description: Bearer token for authenticated customers+ schema:+ type: string+ - name: order_id+ in: path+ required: true+ description: Order ID+ schema:+ type: string+ - name: id+ in: path+ required: true+ description: Order promotion ID+ schema:+ type: string+ - name: order_token+ in: query+ required: false+ description: Order token for guest access+ schema:+ type: string+ responses:+ '200':+ description: coupon code removed+ content:+ application/json:+ example:+ id: or_UkLWZg9DAJ+ number: R140173570+ state: cart+ token: GGo8Fqfeig9xMWAhTSP2WLJDYwUSje6MuLj+ email: [email protected]+ special_instructions:+ currency: USD+ item_count: 1+ shipment_state:+ payment_state:+ item_total: '10.0'+ display_item_total: "$10.00"+ ship_total: '100.0'+ display_ship_total: "$100.00"+ adjustment_total: '0.0'+ display_adjustment_total: "$0.00"+ promo_total: '0.0'+ display_promo_total: "$0.00"+ tax_total: '0.0'+ display_tax_total: "$0.00"+ included_tax_total: '0.0'+ display_included_tax_total: "$0.00"+ additional_tax_total: '0.0'+ display_additional_tax_total: "$0.00"+ total: '110.0'+ display_total: "$110.00"+ completed_at:+ created_at: '2026-02-13T12:13:56.350Z'+ updated_at: '2026-02-13T12:13:56.652Z'+ payment_methods: []+ schema:+ "$ref": "#/components/schemas/StoreOrder"+ '404':+ description: coupon code not found on order+ content:+ application/json:+ example:+ error:+ code: record_not_found+ message: Order promotion not found+ schema:+ "$ref": "#/components/schemas/ErrorResponse""/api/v3/store/customer":get:summary: Get current customer profile@@ -1057,17 +1253,17 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]- first_name: Lita- last_name: Veum- created_at: '2026-02-12T17:55:06.547Z'- updated_at: '2026-02-12T17:55:06.827Z'+ email: [email protected]+ first_name: Senaida+ last_name: Swift+ created_at: '2026-02-13T12:13:57.698Z'+ updated_at: '2026-02-13T12:13:58.003Z'addresses:- id: addr_gbHJdmfrXBfirstname: Johnlastname: Doefull_name: John Doe- address1: 51 Lovely Street+ address1: 75 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1075,14 +1271,14 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_51- state_abbr: STATE_ABBR_51- state_name: STATE_NAME_51+ state_text: STATE_ABBR_75+ state_abbr: STATE_ABBR_75+ state_name: STATE_NAME_75- id: addr_UkLWZg9DAJfirstname: Johnlastname: Doefull_name: John Doe- address1: 50 Lovely Street+ address1: 74 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1090,15 +1286,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_50- state_abbr: STATE_ABBR_50- state_name: STATE_NAME_50+ state_text: STATE_ABBR_74+ state_abbr: STATE_ABBR_74+ state_name: STATE_NAME_74default_billing_address:id: addr_gbHJdmfrXBfirstname: Johnlastname: Doefull_name: John Doe- address1: 51 Lovely Street+ address1: 75 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1106,15 +1302,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_51- state_abbr: STATE_ABBR_51- state_name: STATE_NAME_51+ state_text: STATE_ABBR_75+ state_abbr: STATE_ABBR_75+ state_name: STATE_NAME_75default_shipping_address:id: addr_UkLWZg9DAJfirstname: Johnlastname: Doefull_name: John Doe- address1: 50 Lovely Street+ address1: 74 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1122,9 +1318,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_50- state_abbr: STATE_ABBR_50- state_name: STATE_NAME_50+ state_text: STATE_ABBR_74+ state_abbr: STATE_ABBR_74+ state_name: STATE_NAME_74schema:"$ref": "#/components/schemas/StoreCustomer"'401':@@ -1163,17 +1359,17 @@ paths:application/json:example:id: cus_UkLWZg9DAJ- email: [email protected]+ email: [email protected]first_name: Updatedlast_name: Name- created_at: '2026-02-12T17:55:07.123Z'- updated_at: '2026-02-12T17:55:07.428Z'+ created_at: '2026-02-13T12:13:58.329Z'+ updated_at: '2026-02-13T12:13:58.642Z'addresses:- id: addr_gbHJdmfrXBfirstname: Johnlastname: Doefull_name: John Doe- address1: 53 Lovely Street+ address1: 77 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1181,14 +1377,14 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_53- state_abbr: STATE_ABBR_53- state_name: STATE_NAME_53+ state_text: STATE_ABBR_77+ state_abbr: STATE_ABBR_77+ state_name: STATE_NAME_77- id: addr_UkLWZg9DAJfirstname: Johnlastname: Doefull_name: John Doe- address1: 52 Lovely Street+ address1: 76 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1196,15 +1392,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_52- state_abbr: STATE_ABBR_52- state_name: STATE_NAME_52+ state_text: STATE_ABBR_76+ state_abbr: STATE_ABBR_76+ state_name: STATE_NAME_76default_billing_address:id: addr_gbHJdmfrXBfirstname: Johnlastname: Doefull_name: John Doe- address1: 53 Lovely Street+ address1: 77 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1212,15 +1408,15 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_53- state_abbr: STATE_ABBR_53- state_name: STATE_NAME_53+ state_text: STATE_ABBR_77+ state_abbr: STATE_ABBR_77+ state_name: STATE_NAME_77default_shipping_address:id: addr_UkLWZg9DAJfirstname: Johnlastname: Doefull_name: John Doe- address1: 52 Lovely Street+ address1: 76 Lovely Streetaddress2: Northwestcity: Herndonzipcode: '35005'@@ -1228,9 +1424,9 @@ paths:company: Companycountry_name: United States of Americacountry_iso: US- state_text: STATE_ABBR_52- state_abbr: STATE_ABBR_52- state_name: STATE_NAME_52+ state_text: STATE_ABBR_76+ state_abbr: STATE_ABBR_76+ state_name: STATE_NAME_76schema:"$ref": "#/components/schemas/StoreCustomer"'422':@@ -1311,8 +1507,8 @@ paths:id: li_gbHJdmfrXBvariant_id: variant_gbHJdmfrXBquantity: 2- name: Product 86673- slug: product-86673+ name: Product 147026+ slug: product-147026options_text: ''price: '19.99'display_price: "$19.99"@@ -1331,8 +1527,8 @@ paths:discounted_amount: '39.98'display_discounted_amount: "$39.98"display_compare_at_amount: "$0.00"- created_at: '2026-02-12T17:55:08.743Z'- updated_at: '2026-02-12T17:55:08.743Z'+ created_at: '2026-02-13T12:14:00.017Z'+ updated_at: '2026-02-13T12:14:00.017Z'compare_at_amount:thumbnail_url:option_values: []@@ -1409,8 +1605,8 @@ paths:id: li_UkLWZg9DAJvariant_id: variant_UkLWZg9DAJquantity: 5- name: Product 114685- slug: product-114685+ name: Product 172937+ slug: product-172937options_text: ''price: '19.99'display_price: "$19.99"@@ -1429,8 +1625,8 @@ paths:discounted_amount: '99.95'display_discounted_amount: "$99.95"display_compare_at_amount: "$0.00"- created_at: '2026-02-12T17:55:10.700Z'- updated_at: '2026-02-12T17:55:10.732Z'+ created_at: '2026-02-13T12:14:02.407Z'+ updated_at: '2026-02-13T12:14:02.441Z'compare_at_amount:thumbnail_url:option_values: []@@ -1545,10 +1741,10 @@ paths:example:data:- id: or_UkLWZg9DAJ- number: R327087126+ number: R440830342state: cart- token: rAnetCZT4TCegD55FejqKxEntCjCrqsajsG- email: [email protected]+ token: vXwPgKg5LLUDpQ4nNnk1wKgmCLypqomrbvN+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -1571,8 +1767,8 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:12.616Z'- updated_at: '2026-02-12T17:55:12.831Z'+ created_at: '2026-02-13T12:14:04.506Z'+ updated_at: '2026-02-13T12:14:04.653Z'payment_methods: []meta:page: 1@@ -1631,10 +1827,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R935087135+ number: R297415616state: cart- token: oJLEwqTAddEo4DzGRc51gAYtaodrWM4P4Tt- email: [email protected]+ token: 5T2ZgKcn7P8SvzUJvjW8wgQCmcMqDnFMKiv+ email: [email protected]special_instructions:currency: USDitem_count: 0@@ -1657,10 +1853,10 @@ paths:total: '0.0'display_total: "$0.00"completed_at:- created_at: '2026-02-12T17:55:14.903Z'- updated_at: '2026-02-12T17:55:14.903Z'+ created_at: '2026-02-13T12:14:07.028Z'+ updated_at: '2026-02-13T12:14:07.028Z'payment_methods: []- order_token: oJLEwqTAddEo4DzGRc51gAYtaodrWM4P4Tt+ order_token: 5T2ZgKcn7P8SvzUJvjW8wgQCmcMqDnFMKivschema:type: objectallOf:@@ -1724,9 +1920,9 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R177412687+ number: R068741011state: cart- token: fbuGK2ymZTYHZgnZyQgDGA8B9NAgBtQckgV+ token: E9XBDSnY9VrHAAedLi4GrmJDeAbPZM5kjFRemail:special_instructions:currency: USD@@ -1750,8 +1946,8 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:16.971Z'- updated_at: '2026-02-12T17:55:17.090Z'+ created_at: '2026-02-13T12:14:09.332Z'+ updated_at: '2026-02-13T12:14:09.464Z'payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -1811,10 +2007,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R192630046+ number: R770265799state: cart- token: jYcXypW8c2WuDHqyKWFJM8J9oYXdKSLh3PK- email: [email protected]+ token: rZUknpqyVXEMSkNEuMtoHTGRRhxS1F7d22U+ email: [email protected]special_instructions: Leave at doorcurrency: USDitem_count: 1@@ -1837,8 +2033,8 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:19.396Z'- updated_at: '2026-02-12T17:55:19.545Z'+ created_at: '2026-02-13T12:14:11.895Z'+ updated_at: '2026-02-13T12:14:12.164Z'payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -1967,10 +2163,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R380892960+ number: R784700205state: address- token: g3UTWaFhiVnr6q961J6ndvNW1q83Y4Ji7VW- email: [email protected]+ token: 6kbyrNLPnpPUpenvCLcAynHNaJRKcpHHyZ4+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -1993,8 +2189,8 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:21.077Z'- updated_at: '2026-02-12T17:55:21.238Z'+ created_at: '2026-02-13T12:14:13.916Z'+ updated_at: '2026-02-13T12:14:14.072Z'payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -2046,10 +2242,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R742427424+ number: R564954909state: payment- token: A3txSuZ9Aeza5qTMDhMJmF5qHYqX8HF19H2- email: [email protected]+ token: m6Dzw8njjBh8erhcKWHVcLsvmrf2wNerpGG+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -2072,8 +2268,8 @@ paths:total: '29.99'display_total: "$29.99"completed_at:- created_at: '2026-02-12T17:55:22.754Z'- updated_at: '2026-02-12T17:55:22.988Z'+ created_at: '2026-02-13T12:14:15.703Z'+ updated_at: '2026-02-13T12:14:16.069Z'payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -2114,10 +2310,10 @@ paths:application/json:example:id: or_gbHJdmfrXB- number: R165305820+ number: R921265210state: complete- token: cE2hJYxD7AUsdcbT6iGg8uM5nuJ4qDa7869- email: [email protected]+ token: YwyzQEYLGE6zpDstnzPrW8PVdtKzPDfnRu7+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -2139,9 +2335,9 @@ paths:display_additional_tax_total: "$0.00"total: '29.99'display_total: "$29.99"- completed_at: '2026-02-12T17:55:24.033Z'- created_at: '2026-02-12T17:55:23.686Z'- updated_at: '2026-02-12T17:55:24.033Z'+ completed_at: '2026-02-13T12:14:17.361Z'+ created_at: '2026-02-13T12:14:16.920Z'+ updated_at: '2026-02-13T12:14:17.361Z'payment_methods:- id: pm_UkLWZg9DAJname: Check@@ -2200,10 +2396,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R253258619+ number: R263630307state: cart- token: juS8hSNh8NaDZzjfyRb1Pp1J3nsvvn75HCh- email: [email protected]+ token: Ei61iq99d71LXuBNNNSX4KXxkYHWGSHLgek+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -2226,8 +2422,8 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:25.526Z'- updated_at: '2026-02-12T17:55:25.973Z'+ created_at: '2026-02-13T12:14:19.224Z'+ updated_at: '2026-02-13T12:14:19.797Z'payment_methods:- id: pm_UkLWZg9DAJname: Store Credit@@ -2291,10 +2487,10 @@ paths:application/json:example:id: or_UkLWZg9DAJ- number: R253116366+ number: R862858174state: cart- token: gpAzk7RaZvdJtaReeMNHyyadcQU2TGWUagH- email: [email protected]+ token: VmE9nYzXBXJfTo1SWbMgWBiTaMHNnBp7kPt+ email: [email protected]special_instructions:currency: USDitem_count: 1@@ -2317,8 +2513,8 @@ paths:total: '110.0'display_total: "$110.00"completed_at:- created_at: '2026-02-12T17:55:27.260Z'- updated_at: '2026-02-12T17:55:27.377Z'+ created_at: '2026-02-13T12:14:21.163Z'+ updated_at: '2026-02-13T12:14:21.333Z'payment_methods: []schema:"$ref": "#/components/schemas/StoreOrder"@@ -2435,11 +2631,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PR07NCC9+ number: PIEJ1MWBamount: '110.0'display_amount: "$110.00"- created_at: '2026-02-12T17:55:29.382Z'- updated_at: '2026-02-12T17:55:29.382Z'+ created_at: '2026-02-13T12:14:23.602Z'+ updated_at: '2026-02-13T12:14:23.602Z'payment_method:id: pm_UkLWZg9DAJname: Credit Card@@ -2507,11 +2703,11 @@ paths:payment_method_id: pm_UkLWZg9DAJstate: checkoutresponse_code: '12345'- number: PR1G83EZ+ number: PVBW11ACamount: '110.0'display_amount: "$110.00"- created_at: '2026-02-12T17:55:30.858Z'- updated_at: '2026-02-12T17:55:30.858Z'+ created_at: '2026-02-13T12:14:25.265Z'+ updated_at: '2026-02-13T12:14:25.265Z'payment_method:id: pm_UkLWZg9DAJname: Credit Card@@ -2583,18 +2779,20 @@ paths:example:data:- id: prod_UkLWZg9DAJ- name: Product 468583- description: Aliquid quo reiciendis ducimus blanditiis. Assumenda- vitae optio fugit voluptatem laborum. Cupiditate quibusdam consequuntur- asperiores ab beatae quod. Molestias magni beatae officia quae.- Dolor minima odio placeat officia.- slug: product-468583+ name: Product 5275+ description: |-+ Incidunt labore aspernatur voluptatem qui quis itaque tenetur quaerat. Quibusdam exercitationem saepe asperiores sint ipsum repellendus vitae. Aspernatur non perspiciatis at nostrum fugit voluptas aperiam unde. Impedit soluta mollitia alias doloribus possimus esse. Suscipit distinctio possimus tempore ea voluptas quasi maxime.+ Consequuntur eligendi quos dignissimos cum maxime soluta. Dolore itaque recusandae adipisci ipsum ratione. Illum accusamus praesentium atque ea sunt. Velit earum reiciendis molestiae eos.+ Eum numquam excepturi iste neque dolor nostrum. Praesentium necessitatibus consequuntur nemo error. Officiis praesentium at recusandae laboriosam sapiente. Sequi animi veritatis alias quam laborum.+ Necessitatibus reiciendis doloremque dolor ex consequuntur. Quam quaerat perspiciatis ad nihil ex maiores quo. Tempore esse dolorum nihil maiores.+ Pariatur minima a natus culpa quasi asperiores itaque. Laudantium provident quaerat consectetur alias consequuntur amet. Praesentium id eius voluptatum quasi neque velit hic commodi. Pariatur quaerat sit eveniet possimus autem facilis laborum animi. Hic doloribus laboriosam voluptatibus excepturi quaerat totam.+ slug: product-5275meta_description:meta_keywords:variant_count: 1- available_on: '2025-02-12T17:55:31.661Z'- created_at: '2026-02-12T17:55:31.683Z'- updated_at: '2026-02-12T17:55:31.782Z'+ available_on: '2025-02-13T12:14:26.117Z'+ created_at: '2026-02-13T12:14:26.141Z'+ updated_at: '2026-02-13T12:14:26.264Z'purchasable: truein_stock: falsebackorderable: true@@ -2614,19 +2812,18 @@ paths:price_list_id:original_price:- id: prod_gbHJdmfrXB- name: Product 476626- description: Earum esse amet maiores voluptatem tempore quasi vero- temporibus. Sunt facere placeat aperiam soluta exercitationem- nulla numquam saepe. Qui earum in dolore fugiat similique soluta.- Accusantium exercitationem tempore commodi maxime laudantium illo- adipisci.- slug: product-476626+ name: Product 537141+ description: Soluta nulla consequuntur distinctio eveniet laboriosam+ maiores voluptas. Architecto tenetur aut minus vel. Deserunt reiciendis+ cum repudiandae doloremque facilis incidunt aut. Distinctio labore+ dolore saepe officiis vero magni nam nobis.+ slug: product-537141meta_description:meta_keywords:variant_count: 0- available_on: '2025-02-12T17:55:31.803Z'- created_at: '2026-02-12T17:55:31.817Z'- updated_at: '2026-02-12T17:55:31.846Z'+ available_on: '2025-02-13T12:14:26.291Z'+ created_at: '2026-02-13T12:14:26.305Z'+ updated_at: '2026-02-13T12:14:26.340Z'purchasable: truein_stock: falsebackorderable: true@@ -2711,19 +2908,19 @@ paths:application/json:example:id: prod_UkLWZg9DAJ- name: Product 58563+ name: Product 644760description: |-- Ipsum possimus laborum sapiente ex minima dolorem. Maiores inventore ex dolores quidem sunt. Quidem dolorem perspiciatis eius a sit.- Accusantium occaecati nesciunt sit minima soluta. Nulla cupiditate tempore minus magnam sapiente dolorum nisi error. Reiciendis similique placeat eveniet vero tenetur unde omnis iusto.- Quam eligendi animi officiis beatae doloribus provident aliquam. Unde dignissimos qui ab aliquam. A quibusdam quis saepe nesciunt iusto illo animi. Quas fugit placeat quia sunt beatae neque.- Nemo tempora ea voluptatem voluptas occaecati accusamus corrupti. Fugiat ex a quidem ratione aliquam. Voluptates sit nemo accusamus nostrum. Maiores amet numquam dolorem incidunt in maxime animi.- slug: product-58563+ Itaque ullam tenetur quia inventore architecto vero. Hic sit earum iste totam nulla explicabo minima quisquam. Commodi velit autem harum provident. Nesciunt impedit molestias ipsam provident. Delectus ut cumque eveniet praesentium in harum inventore.+ Consequatur maxime perferendis exercitationem facilis beatae quas aliquid. Qui vero dolorem vel accusantium delectus odio. Animi tempore enim accusamus exercitationem aliquid. Facilis sapiente nesciunt sequi ipsa. Incidunt nesciunt animi distinctio temporibus iusto itaque.+ Laudantium sit facere voluptates quia. Nam velit magnam eveniet soluta necessitatibus ducimus debitis. Sunt voluptatibus atque architecto quod magni facilis.+ Corporis distinctio quasi eaque suscipit. Quis hic culpa velit deserunt nihil nostrum mollitia debitis. Quos ex quis eveniet consectetur consequuntur sapiente commodi pariatur. Minima quis cum repellat incidunt.+ slug: product-644760meta_description:meta_keywords:variant_count: 1- available_on: '2025-02-12T17:55:33.074Z'- created_at: '2026-02-12T17:55:33.091Z'- updated_at: '2026-02-12T17:55:33.194Z'+ available_on: '2025-02-13T12:14:28.153Z'+ created_at: '2026-02-13T12:14:28.200Z'+ updated_at: '2026-02-13T12:14:28.337Z'purchasable: truein_stock: falsebackorderable: true@@ -2928,29 +3125,29 @@ paths:example:data:- id: ship_UkLWZg9DAJ- number: H46525164226+ number: H68953003585state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-12T17:55:37.012Z'- updated_at: '2026-02-12T17:55:37.034Z'+ created_at: '2026-02-13T12:14:33.514Z'+ updated_at: '2026-02-13T12:14:33.546Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_195- name: Layla Schoen+ state_abbr: STATE_ABBR_219+ name: Natashia Schambergeraddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_195+ state_text: STATE_ABBR_219shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -3041,29 +3238,29 @@ paths:application/json:example:id: ship_UkLWZg9DAJ- number: H30441009501+ number: H06987127089state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-12T17:55:38.420Z'- updated_at: '2026-02-12T17:55:38.488Z'+ created_at: '2026-02-13T12:14:35.113Z'+ updated_at: '2026-02-13T12:14:35.147Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_203- name: Jone Gleason+ state_abbr: STATE_ABBR_227+ name: Selene Kulasaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_203+ state_text: STATE_ABBR_227shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -3130,29 +3327,29 @@ paths:application/json:example:id: ship_UkLWZg9DAJ- number: H69321060370+ number: H20140934010state: pendingtracking: U10000tracking_url:cost: '100.0'display_cost: "$100.00"shipped_at:- created_at: '2026-02-12T17:55:39.880Z'- updated_at: '2026-02-12T17:55:39.931Z'+ created_at: '2026-02-13T12:14:36.865Z'+ updated_at: '2026-02-13T12:14:36.947Z'shipping_method:id: shpm_UkLWZg9DAJname: UPS Groundcode: UPS_GROUNDstock_location:id: sloc_UkLWZg9DAJ- state_abbr: STATE_ABBR_211- name: Trudie Kautzer+ state_abbr: STATE_ABBR_235+ name: Gladys Schroederaddress1: 1600 Pennsylvania Ave NWcity: Washingtonzipcode: '20500'country_iso: UScountry_name: United States of America- state_text: STATE_ABBR_211+ state_text: STATE_ABBR_235shipping_rates:- id: shpr_UkLWZg9DAJshipping_method_id: shpm_UkLWZg9DAJ@@ -3222,8 +3419,8 @@ paths:instagram: spreecommercecustomer_support_email: [email protected]default_locale: en- created_at: '2026-02-12T17:54:53.158Z'- updated_at: '2026-02-12T17:54:53.314Z'+ created_at: '2026-02-13T12:13:37.926Z'+ updated_at: '2026-02-13T12:13:38.050Z'default_country_iso: USsupported_currencies:- USD@@ -3288,32 +3485,32 @@ paths:- id: txnmy_UkLWZg9DAJname: Categoriesposition: 1- created_at: '2026-02-12T17:54:53.173Z'- updated_at: '2026-02-12T17:54:53.197Z'+ created_at: '2026-02-13T12:13:37.936Z'+ updated_at: '2026-02-13T12:13:37.959Z'root_id: txn_UkLWZg9DAJ- id: txnmy_gbHJdmfrXBname: Brandsposition: 2- created_at: '2026-02-12T17:54:53.198Z'- updated_at: '2026-02-12T17:54:53.209Z'+ created_at: '2026-02-13T12:13:37.960Z'+ updated_at: '2026-02-13T12:13:37.971Z'root_id: txn_gbHJdmfrXB- id: txnmy_EfhxLZ9ck8name: Collectionsposition: 3- created_at: '2026-02-12T17:54:53.210Z'- updated_at: '2026-02-12T17:54:53.318Z'+ created_at: '2026-02-13T12:13:37.972Z'+ updated_at: '2026-02-13T12:13:38.054Z'root_id: txn_EfhxLZ9ck8- id: txnmy_VqXmZF31wYname: taxonomy_11position: 4- created_at: '2026-02-12T17:55:40.659Z'- updated_at: '2026-02-12T17:55:40.669Z'+ created_at: '2026-02-13T12:14:37.821Z'+ updated_at: '2026-02-13T12:14:37.835Z'root_id: txn_OIJLhNcSbf- id: txnmy_uw2YK1rnl0name: taxonomy_12position: 5- created_at: '2026-02-12T17:55:40.670Z'- updated_at: '2026-02-12T17:55:40.679Z'+ created_at: '2026-02-13T12:14:37.837Z'+ updated_at: '2026-02-13T12:14:37.847Z'root_id: txn_AXs1igzRC6meta:page: 1@@ -3379,8 +3576,8 @@ paths:id: txnmy_VqXmZF31wYname: taxonomy_17position: 4- created_at: '2026-02-12T17:55:40.957Z'- updated_at: '2026-02-12T17:55:40.965Z'+ created_at: '2026-02-13T12:14:38.190Z'+ updated_at: '2026-02-13T12:14:38.201Z'root_id: txn_OIJLhNcSbfschema:"$ref": "#/components/schemas/StoreTaxonomy"@@ -3436,8 +3633,8 @@ paths:meta_description:meta_keywords:children_count: 1- created_at: '2026-02-12T17:55:41.604Z'- updated_at: '2026-02-12T17:55:41.622Z'+ created_at: '2026-02-13T12:14:38.960Z'+ updated_at: '2026-02-13T12:14:38.977Z'parent_id: txn_OIJLhNcSbftaxonomy_id: txnmy_VqXmZF31wYdescription: ''@@ -3508,9 +3705,9 @@ paths:data:- id: wl_UkLWZg9DAJname: My Wishlist- token: Wmxm6NysbSHYMCMSH2DDbPWW- created_at: '2026-02-12T17:55:42.844Z'- updated_at: '2026-02-12T17:55:42.844Z'+ token: yqyFPXrRy8x8HKkPfg16pnAd+ created_at: '2026-02-13T12:14:40.423Z'+ updated_at: '2026-02-13T12:14:40.423Z'is_default: falseis_private: truemeta:@@ -3569,9 +3766,9 @@ paths:example:id: wl_gbHJdmfrXBname: Birthday Ideas- token: hSs928EFKj3kZmAL57j44pyu- created_at: '2026-02-12T17:55:44.257Z'- updated_at: '2026-02-12T17:55:44.257Z'+ token: t76h36antxrTL696XUYcSvvH+ created_at: '2026-02-13T12:14:41.966Z'+ updated_at: '2026-02-13T12:14:41.966Z'is_default: falseis_private: trueschema:@@ -3644,9 +3841,9 @@ paths:example:id: wl_UkLWZg9DAJname: My Wishlist- token: zBTvgR6SFZs1iXwPAi6Bt1nM- created_at: '2026-02-12T17:55:45.474Z'- updated_at: '2026-02-12T17:55:45.474Z'+ token: NBxGB6bhfxC6AtQpoLDSwWyJ+ created_at: '2026-02-13T12:14:43.371Z'+ updated_at: '2026-02-13T12:14:43.371Z'is_default: falseis_private: trueschema:@@ -3692,9 +3889,9 @@ paths:example:id: wl_UkLWZg9DAJname: Updated Name- token: dWfWi5AnjxqMrMQiCVxESctW- created_at: '2026-02-12T17:55:46.743Z'- updated_at: '2026-02-12T17:55:46.826Z'+ token: oTPtRRsTUdSq1dEDqs9i9mAj+ created_at: '2026-02-13T12:14:44.952Z'+ updated_at: '2026-02-13T12:14:45.061Z'is_default: falseis_private: trueschema:@@ -3775,18 +3972,18 @@ paths:variant_id: variant_gbHJdmfrXBwishlist_id: wl_UkLWZg9DAJquantity: 1- created_at: '2026-02-12T17:55:48.185Z'- updated_at: '2026-02-12T17:55:48.185Z'+ created_at: '2026-02-13T12:14:46.733Z'+ updated_at: '2026-02-13T12:14:46.733Z'variant:id: variant_gbHJdmfrXBproduct_id: prod_gbHJdmfrXB- sku: SKU-111+ sku: SKU-117is_master: trueoptions_text: ''track_inventory: trueimage_count: 0- created_at: '2026-02-12T17:55:48.136Z'- updated_at: '2026-02-12T17:55:48.163Z'+ created_at: '2026-02-13T12:14:46.655Z'+ updated_at: '2026-02-13T12:14:46.694Z'thumbnail:purchasable: truein_stock: false@@ -3881,10 +4078,14 @@ tags:description: Individual categories- name: Countriesdescription: Available shipping countries+- name: Cart+ description: Shopping cart management- name: Orders- description: Shopping cart and checkout+ description: Order management and checkout- name: Line Itemsdescription: Cart item management+- name: Coupon Codes+ description: Coupon code and gift card management- name: Paymentsdescription: Payment processing- name: Payment Methods@@ -3901,6 +4102,33 @@ tags:description: Customer wishlists- name: Digitalsdescription: Digital product downloads+x-tagGroups:+- name: Store+ tags:+ - Store+ - Countries+- name: Catalog+ tags:+ - Products+ - Taxonomies+ - Taxons+- name: Checkout+ tags:+ - Cart+ - Orders+ - Line Items+ - Coupon Codes+ - Payments+ - Payment Methods+ - Shipments+- name: Customer+ tags:+ - Authentication+ - Customers+ - Addresses+ - Credit Cards+ - Wishlists+ - Digitalscomponents:securitySchemes:api_key: