active 的优惠券创建促销码,促销码与优惠券属于同一店铺、同一环境。创建促销码不会改变优惠券的优惠内容。
促销码状态值
附加限制
每个促销码有各自的买家限制;优惠券的redeemBy 与 maxRedemptions 同样对每个码生效:
促销码可以在创建优惠券时一并创建(创建优惠券,最多 20 个),也可以用下面的端点单个或批量创建。优惠券自己的
code 不属于它的促销码:它没有自己的限制,promotionCodes 不返回它,只能随优惠券一起停用。
码
促销码与优惠券使用同一套码格式:3–32 个字母、数字或-,不区分大小写,以大写存储,在同一店铺、同一环境的有效码中唯一,停用后释放。不传 code 或批量生成时,随机部分由大写字母和数字组成,并去掉了容易混淆的 0、O、1、I、L。
安全重试
请带上X-Idempotency-Key 请求头(SDK 中为 idempotencyKey 选项),重试时沿用同一个键。这对批量生成促销码尤其重要:码是随机生成的,不带键重试会再生成一批。幂等键的要求见错误处理。
读取促销码
这些端点只负责写入。优惠券下的促销码请用 GraphQL 的promotionCodes 和 promotionCodesCount 查询;按 batchId 过滤可重新读取某一批生成的码。
端点
创建促销码
为优惠券新增一个促销码。
批量生成促销码
一次生成 1–500 个随机促销码。
停用促销码
永久停用促销码并释放它的码。