一商户接入前提条件-迅雷积分.docVIP

迅雷积分商城返利平台接口规范V1.0 日期 修订版本 修改 作者 审核修改 2013-03-28 V1.0 初稿制定 忠磊 V哥 2013-04-23 V1.2 增加了对商户整站商品的接入 忠磊 V哥 平台简介： 积分商城返利平台是一个允许第三方商户接入，以迅雷帐号联合登录为基础，用迅雷帐号的积分参与到商户的商品购买中，从而实现流量变现的合作关系。它大概分为以下两种业务： 1：针对具体商户中的具体某个商品用积分进行兑换购买后再将用户所消费的部分积分返还给用户。(即N积分可以兑换X元钱，购买后返B积分给用户) 2：合作商户的所有商品在用户购买后都将返回一定比例的积分给用户。(即用户购买任意商品后都将返回N积分) 开发： 迅雷会员帐号组 版权所有： 深圳迅雷网络科技 一：商户接入前提条件 1：必须是与积分商城签约的商户。签约后商户会得到唯一的商户ID和对应的密钥，该密钥在双方通信时要进行数字签名认证用。 2：接入积分商城前商户必须已经对接好迅雷的联合登录，即用迅雷帐号可以登录商户网站。 二：操作流程图 业务一：积分换购（针对商户的具体某个商品） 说明： 1：“购买商品”：是指积分商城与商家合作的特定商品，它会有一个对应的唯一返利平台的链接，这个链接可以是在任何地址，不仅限于返利平台之上，对程序来讲它就是一个URL地址。 2：“登记后跳转”这里会跳转每个商品事选设定好的详细地址，该地址由商户所提供。 3：“购买详细页”用户到了商户的这个页面时，返利平台会确保迅雷用户已正常登录了，并且会带上必要的参数传给商户，此时商户自己要进行迅雷用户的登录处理和相关参数的记录。 4：“下单处理”必须是由返利平台跳转过来并且是跳转前后是同一迅雷用户下的订单才能将其状态推送到返利平台，非这种情况的订单推送接口将拒绝接受。 业务二：直接购买返积分（针对商户的所有商品） 三：跳转到商户详细页URL格式及参数说明。(仅限业务一) [示例URL格式] http://商户商品购买详细页面地址?ex_score_pay=2000ex_money_return=100ex_score_return=500goodsn=orderid=201303281214040100000001uid=102345sign=xxxxx 参数 类型(长度) 举例 说明 ex_score_pay int =0 参与支付的积分，可以为0，表示不扣用户的积分只返利积分 ex_money_return int =0 支付积分所兑换的金额，单位是人民币的最小单位”分”,可以是0，表示不参与兑换。 ex_score_return int =0 返利的积分 goodsn String(10) o迅雷商品编号 orderid String(24) 201303281214040100000001 迅雷订单号 uid int 0 迅雷用户ID sign String(32) xxxxxxx 数字签名【参见每四项的第4点】 综合以上”示例URL格式”对应的逻辑是： 用户购买该商品时用2000积分来兑换1块钱人民币，并且交易成功后给他返回500个积分。 四：返利平台推送服务接口协议说明 1：订单推送接口及参数协议 协议 HTTP/POST 数据编码格式 UTF8 测试环境hosts 47 测试地址 /call?c=ownera=gateway 正式线上地址 /call?c=ownera=gateway 2：POST字段说明 字段名 类型 举例 是否必填 说明 merchantid string merchant_001 是 迅雷分配的商家标识ID xlorderid String(24) 201303281214040100000001 或 “” 是 迅雷订单号,积分换购必须填；全站购买返积分时为空 uid int 0 是 迅雷用户ID，注意一定要有。 orderno string xxxxxx 是 商户订单号 ordertype Int [0 | 1] 是 订单类型，正常或特价。这和佣金比例有关，正常订单佣金比例会高些。 默认：0 特价：1 orderamt int 0 是 用户实际支付的金额，不含邮费，单位:分 goodsdata String [{id:1001,name:name1,number:1,price:198}, {id:1002,name:name2,number:3,price:342}] 是 Json格式串的