原创力文档- 1、本文档共8页，可阅读全部内容。
- 2、原创力文档（book118）网站文档一经付费（服务费），不意味着购买了该文档的版权，仅供个人/单位学习、研究之用，不得用于商业用途，未经授权，严禁复制、发行、汇编、翻译或者网络传播等，侵权必究。
- 3、本站所有内容均由合作方或网友上传，本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺！文档内容仅供研究参考，付费前请自行鉴别。如您付费，意味着您自己接受本站规则且自行承担风险，本站不退款、不进行额外附加服务；查看《如何避免下载的几个坑》。如果您已付费下载过本站文档，您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等，请点击“版权申诉”（推荐），也可以打举报电话：400-050-0827(电话支持时间：9:00-18:30)。
查看更多
权益直发业务接入文档.PDF
权益直发业务接入文档
一、 业务介绍
权益营销业务将划分为两类业务场景，权益直发和权益抽奖玩法。权益直
发业务是主要支持的确定性的权益发放，如积分兑换、签到送权益等 ，目前支
持的权益为包括红包、流量钱包，后续计划支持的有淘话费、彩票、粮票、优
酷会员卡等。
目前实现权益直发业务需要使用的接口为权益中心增值包。
二、 业务流程图
总体流程图 ：
三、 接口调用逻辑 （以流量钱包为例）
1、 通过权益选择器接口查询目前支持的权益类型
调用 motion.benefit.selector 商家支持的权益类型,query 参数传
入值{ step: 1 }
JAVA 示例如下：
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionBenefitSelectorRequest req = new PromotionBenefitSelectorRequest();
BenefitSelectorQuery obj1 = new BenefitSelectorQuery();
obj1.setStep(1L);
req.setQuery(obj1);
PromotionBenefitSelectorResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
解析返回值中的可以得到流量钱包的 benefit_type_long 为4
{
promotion_benefit_selector_response: {
benefit_list: {
benefit_selector_vo: [
{
benefit_name: 支付宝红包,
benefit_type: ALIPAY_COUPON,
benefit_type_long: 1
},
{
benefit_name: 流量钱包,
benefit_type_long: 4
},
{
benefit_type_long: 12
},
{
benefit_name: 彩票,
benefit_type_long: 14
}
]
},
is_success: true,
request_id: qpmxfkkk55sj
}
}
2、 再通过权益选择器接口查询商家已经创建的某一类权益的模板
调用 motion.benefit.selector 商家支持的权益类型,根据第一调用
获取的流量钱包的 benefit_type_long 为4 ，赋值到configId 中，设置step
值为 2 ，生成query 参数值为{config_id: 4,step: 2} ，传入API 后获取商家
创建的流量钱包模板
JAVA 示例如下：
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionBenefitSelectorRequest req = new PromotionBenefitSelectorRequest();
BenefitSelectorQuery obj1 = new BenefitSelectorQuery();
obj1.setStep(1L);
obj1.setConfigId(4L);
req.setQuery(obj1);
PromotionBenefitSelectorResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
解析返回值中的可以得到流量钱包的 benefit_type_long 为4
{
promotion_benefit_selector_r
文档评论（0）