跳转到主要内容
促销码是买家可以为某张已有优惠券输入的另一个码。它享受该优惠券的优惠。优惠券只限制到期时间与总使用次数,买家限制设置在每个促销码上。适合给某位达人、某个推广渠道单独发码,或批量生成一次性码。 只能为 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 个随机促销码。

停用促销码

永久停用促销码并释放它的码。