Discounts

https://api.platformdtc.com/api/v1/discounts

​

Endpoints

• POST /discounts · GET /discounts?method=&status=&class= (cursor paginated) · GET /discounts/{id} · PUT /discounts/{id} · DELETE /discounts/{id}
• POST /discounts/{id}/codes — bulk-add codes to a code discount
• GET /discounts/lookup?code=SAVE20 — resolve a code to its discount

curl -s -X POST https://api.platformdtc.com/api/v1/discounts \
  -H "X-Agent-Key: sq_agt_*" -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Summer 20%","method":"code","discount_class":"order",
       "value_type":"percentage","value":20,"codes":["SUMMER20"],"usage_limit":1000}'

​

Volume discounts (quantity tiers)

curl -s -X POST https://api.platformdtc.com/api/v1/discounts \
  -H "X-Agent-Key: sq_agt_*" -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Buy More, Save More","method":"automatic","discount_class":"product",
       "value_type":"percentage","value":10,
       "applies_to":{"quantity_tiers":[{"min_quantity":2,"value":10},{"min_quantity":3,"value":15},{"min_quantity":4,"value":20}],
                     "collection_ids":["<collection id>"]},
       "combines_with":{"order_discounts":true}}'

• value_type is one type for every tier: percentage, or fixed_amount = amount off each eligible item.
• Scope with product_ids and/or collection_ids; with neither, every product is eligible.
• The tier is picked by the total quantity of eligible items in the cart; the highest tier reached applies.
• Tiers must be unique, whole quantities, and each higher quantity must give a bigger discount (max 10 tiers). No usage_limit / once_per_customer.
• Combinations: a code stacks only when the code has combines_with.product_discounts: true and the volume discount allows the code’s class (order_discounts / shipping_discounts). Otherwise the shopper gets whichever saves more; a code that saves less is refused with a message.
• One automatic product discount per cart line (the one that saves the most). Member pricing does not stack with it. It applies to the first payment of a subscription, not renewals.
• usage_count counts the orders it was applied to; a refund releases it.