聚速通视频会员充值接口文档

1、聚速通视频会员充值接口文档1、编写目的 22、网络协议 23、签名和安全 24、接口说 34.1 参数的获取 34.2 充值接口 34.3 查询接口 44.4 异步通知接口 54.5 余额查询接口 65、报文状态说 65.1 订购接口说 65.2 查询接口说 71、编写目的本文档说明了充值平台下游对接供货接口协议（即通过网络向聚速通充值平台发送视频会员（包括腾讯视频、优酷土豆、爱奇艺视频等）充值订单， 由聚速通平台完成视频会员充值功能的应用场景下，需遵循此协议规则），供使用该接口的合作商和本项目的后续开发维护人员使用。2、网络协议（1）返回格式为默认为xml,如果http请求返回500错误，务

2、必在 请求头 Accept加上application/xml ;如需返回json 格式，请把 http 请求头中的 Accept 改为 application/json;charset=UTF-8 。（2）下单操作为异步请求，报文返回成功，则表示受理成功，具体 充值是否成功，则需要我方发起异步通知，或者下游发起查询请求来 判断。3、签名和安全加密方式为MD5。将请求参数中的各个键值对按照key的字符串 顺序升序排列（自然序），value拼成一串之后最后加上密钥组成字 符串，取utf8字节后再做md5加密（32位小写）。privateKey（密钥）由充值平台方分配，请妥善保存。上线之前请 告知充

3、值平台方技术，请求服务器IP列表，通过IP白名单加强交 易安全。4、接口说明功能接口类型说明直充直充接口http 异步异步对话费进行供货订单结果查询接口http同步根据合作方的流水号，查询订单信息。异步通知接口http同步我方订单成功还是失败，通知合作方。账号余额查询合作商账号余额查询接口http同步获取账户内余额等信息4.1参数的获取1、找商务人员获取用户编号（userid ）、下单地址、privateKey以 及商品编码。2、提供回调地址及IP给商务人员绑定4.2充值接口请求（系统间请求）目的URLhttp/ 下单地址 /unicomAync/buy.do字段名必填说明userid是合作方

4、用户编号（充值平台方提供）itemid是商品编号（充值平台方提供）amt是购买数量uid是充值账号serialno是合作方商户系统的 流水号，全局唯一（不能重复使用）dtCreate是合作方交易时间（也可以是订单创建时间，格式为：yyyyMMddHHmmss）sign是签名(MD5) sign=MD5(value1value2value3value4private key);MD5(amt dtCreate itemId serialno uid userid key)http:/XXXXX/unicomAync/buy.do?sign=b5b316640bc7fb908d5dc4851e6f

5、9874& uidamp;dtCreate=20160620145557&userid=236&itemid=14977&seria lno=1466405757596返回：<?xml version="1.0" encoding="UTF-8" ?><response><status>success</status><code>00</code ><desc>交易成功 </desc><amoun

6、t>29718</amount> / 交易总金额<areaCode>330000</areaCode> / 省域代码<bizOrderId>37088</bizOrderId> /充值平台方流水号订单号<carrierType>3</carrierType> /运营商类别<itemFacePrice>3000</itemFacePrice> /商品面值单位为厘<itemId>136</itemId> / 商品编号<itemName冷国移动话费3元<

7、;/itemName><price>29718</price> / 商品单价<serialno>123333</ serialno> /合作方流水号</response>注：此处返回“交易成功”，表示受理成功，并不代表，充值成功，下游代理商 需要通过异步通知接口，获取发起查询请求来确保充值是否成功。A、md5力口密(32位小写)。R MD5(dtCreate itemId serialno uid userId key)顺序G参数用户名是否有空格4.3查询订单接口请求（系统间请求）目的URLhttp/下单地址 /unicomAy

8、nc/queryBizOrder.do字段名必填说明userId是合作方用户编号（充值平台方提供）serialno是合作方商户系统的流水号，全局唯一sign是签名(MD5) sign=MD5(serialno+userId+privatekey);<?xml version="1.0" encoding="UTF-8" ?>response<status>success</status><desc>交易成功 </desc><code>00</code ><data&

9、gt;<id>12321344</id> /我方流水号订单号<serialno>1232133</ serialno> /合作方流水号<amount>10000</amount> /实际交易金额，厘为单位<amt>1</ amt > / 购买数量<status>2</status> /0或者1处理中2成功3失败4充值锁定中(是处理中)9未确认(也是处理中)<statusDesc> 成功 </statusDesc><itemId>1001&l

10、t;/ itemId ><gmtCreate>20140301 00:00:00</gmtCreate> /订单创建时间<gmtModify>20140301 00:00:00</ gmtModify > / 交易完成时间</data></response>4.4异步通知接口请求（系统间请求）目的URL合作方提供的回调 URL字段名必填说明userId是合作方用户编号（充值平台方提供）bizId是业务编号ejId是充值平台方订单号downstreamSerialno是合作方商户系统的流水号status是状态2是成功3

11、是失败sign是签名(MD5) sign=MD5(bizId+downstreamSerialno+ejId+status +userId + privatekey );异步回调（采用GET!f式）：http:/xxxxxxx/xxx?userId=1&bizId=200&ejId=123188&downstreamSerialno= 123188&status=2&sign=3945c4cb677e0d39cea1765b015dc237返回success注意：这里下游用户接受到异步回调，必须返回字符：success（小写）, 如果没有返回，将会继续进

12、行通知回调，最多回调3次，间隔10秒。4.5余额查询接口请求（系统间请求）目的URLhttp/ 下单地址 /unicomAync/queryBalance.do字段名必填说明userid是合作方用户编号（充值平台方提供）sign是签名(MD5) sign=MD5( userid + privatekey );返回：<?xml version="1.0" encoding="UTF-8" ?><response><status>success</status><desc>交易成功 </des

13、c><code>00</code ><balance>100000</balance> / 以厘为单位 100 元</response>5、报文状态说明5.1订购接口说明字段名code说明STATUSstatussuccess表小父易成功。statusfailed表小交勿失败。CODEcode00受理成功。（具体是否充值成功通过回调或者查询来判断）code10缺少参数，或者参数类型错误code11校验码验证失败code12白名单校验失败code20商品状态相关错误code21商品价格错误code22订单相关错误code23流水号重复code25手机归属地错误code28黑名单相关错误code30上游供货失败code31上游供货超时（如果是该状态，请不要确认本次购买是失败的， 因 为是网络读写超时了，需要通过对账，或者人工来处理本次交易）code40合作方账号类型或者状态错误code41合作方资金账户错误code42合作方余额不足等错误code43合作方支付错误code44合作方没有该业务权限code50系统异常code51交易繁忙，上游供货繁忙。根据code来判断，code00表示受理成功，code31以及文档外的 作未确认，其他作