v2

latestOpenAPI 3.0.3Proprietary2026-07-263483431.1 MB
Discounts

Check discount code validity

Public storefront endpoint. Validate discount eligibility against the checkout context before order creation. If X-Scalev-Guest-Token resolves a non-empty guest cart, the cart is used as the item source. Otherwise the request may provide direct items[] with variant IDs. Unknown or ineligible codes return a validation result with is_eligible: false; the route itself only returns 404 when the store cannot be resolved.

post/v3/stores/{store_id}/public/discount-codes/check

Request body

codestring required

Discount code to validate.

warehouse_unique_idstring
courier_aggregator_codestring nullable
payment_methodstring

Storefront payment method code selected by the buyer.

Example request

{
  "code": "SAVE10",
  "payment_method": "bank_transfer"
}

Response

Discount code validation result

eligibility_detailsobject required
is_eligibleboolean required