首页 > API调用场景 > 优惠券API调用场景

优惠券API调用场景

优惠券使用场景

.优惠券业务介绍:

1.1详细的优惠券规则说明:请查看https://www.jd.com/phb/zhishi/bc817e636cd7943e.html

1.2 Pop商家优惠券操作手册:https://helpcenter.jd.com/vender/issue/767-5171.html

1.3自营商家优惠券操作手册:

https://helpcenter.jd.com/vender/issue/767-5474.html

二、优惠券API使用规则:

2.1优惠券直发规则:优惠接口可用于 pop 店铺直接发放到用户账户中,但ISV互动页面前端必须有用户点击操作后才能发放。为避免打搅用户,不允许在用户无感知、不知情的情况下,直接发放用户账户中。

2.2自营店铺优惠券发放规则:自营优惠券不支持通过接口拉取,需商家通过采销申请获取领取型优惠券的链接,优惠券活动类型须为【免费领券】,需商家申请采销审核后才能获取优惠券,ISV工具中提供商家填写优惠券链接的地方,让C端用户跳转到该优惠券官方页面,手动点击后领取;

2.3 另:为进一步规范优惠券业务模型,同时避免不合规数据引入的可能风险导致造成商家损失,近期针对京券限额数值在创建环节增加强制入参校验,校验生效时间为2020428日,届时所有不合规调用方的建券请求直接失败,涉及接口如下:

jingdong.seller.coupon.write.lockCoupon

jingdong.seller.coupon.write.pushCoupon

jingdong.seller.coupon.write.create

调用接口失败场景的说明:创建优惠券类型为“京券”,quota(优惠券限额)和discount(优惠券面额)均有传值会导致接口失败,京券不应有优惠券限额


三、优惠券发放逻辑:

Pop店铺优惠券发放

1.     接口面向C端用户时需要做加密及防刷处理,防止黄牛等恶意用户通过http服务刷券及跳过相应逻辑。

2.     领券链接为优惠券的钥匙,是静态参数,拿到链接后可以任意传播及领取,当不期望被传播时,不要露出任何链接或组成链接的关键字段给到用户(roleIdkey

3.     grantType=3"免费抢券,使用场景为生成领券链接供用户随意领取,可露出到商详页,传播性强,安全性低。

4.     grantType=5其他营销,使用场景为系统发券,限制发放渠道(锁券方可发券),没有领券链接,只能通过接口发券,不会在单品页等公域露出,安全性较高。

5.     我该用什么活动类型?

1.      场景一:日常活动,露出在单品页、领券中心,配置到通天塔等地方,用户可以随意领取,随意传播——免费抢券(推广范围广,无需系统开发)

2.      场景二:需要用户完成某些任务或者门槛才可以领券,如抽奖系统、红包雨、奖励系统、会员发券、新人大礼包、积分兑换系统等,需要自行进行控制是否发券——其他营销(锁定渠道,更安全)

自营店铺优惠券发放