优惠券发放

根据优惠券模板创建一个或多个优惠券,用户在支付订单前,可以使用优惠券进行订单金额的折扣。

coupon

  1. 你可以根据用户的领取请求或者你主动向用户发送优惠券的方式,使用 Dashboard 或者 Server-SDK 的优惠券创建 API 发起请求;

  2. Ping++ 响应你的服务端请求,返回优惠券对象。服务端可以查看该用户的优惠券列表返回给客户端显示。

在设置优惠券前,可能需要查看用户的优惠券列表。将可用的优惠券列表展示给用户,让用户进行选择。

Ping++ 对可用优惠券的定义为:

  • 优惠券对应的模板未删除。
  • 优惠券在有效期内。
  • 订单的总金额满足优惠券的满减规则(可在查询优惠券列表时传入订单总金额)

除此之外,你也可以自行控制优惠券的可用逻辑,例如在优惠券模板创建时在自定义字段(metadata)中传入了优惠券可用品类信息。在优惠券列表展示将不满足条件的优惠券显示为不可用。

注意事项:

  1. 优惠券在创建订单时使用,详情请参考 API 文档 订单创建
  2. 优惠券还支持批量创建,请使用优惠券批量创建 API 为多个用户发放优惠券。
  3. 订单创建时会检查优惠券 ID 是否属于订单消费用户,以及优惠券是否过期。
  4. 优惠券会在订单取消时自动退还。
  5. 订单全额退款时是否退还优惠券可以在优惠券模板中配置。