Auth: X-Agent-Key: sq_agt_*. Scopes: read_discounts, write_discounts. A discount has a method (code | automatic), a class (product | order | shipping), a value_type (percentage | fixed_amount) and a value, with optional starts_at/ends_at, usage_limit, once_per_customer, and combines_with.

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
Emits discounts/create|update|delete. (Legacy PriceRule is not used — this is the current model.)