聚速通視頻會員充值接口文檔

1、聚速通視頻會員充值接口文檔1、編寫目的 22、網(wǎng)絡(luò)協(xié)議 23、簽名和安全 24、接口說 34.1 參數(shù)的獲取 34.2 充值接口 34.3 查詢接口 44.4 異步通知接口 54.5 余額查詢接口 65、報文狀態(tài)說 65.1 訂購接口說 65.2 查詢接口說 71、編寫目的本文檔說明了充值平臺下游對接供貨接口協(xié)議（即通過網(wǎng)絡(luò)向聚速通充值平臺發(fā)送視頻會員（包括騰訊視頻、優(yōu)酷土豆、愛奇藝視頻等）充值訂單， 由聚速通平臺完成視頻會員充值功能的應(yīng)用場景下，需遵循此協(xié)議規(guī)則），供使用該接口的合作商和本項目的后續(xù)開發(fā)維護人員使用。2、網(wǎng)絡(luò)協(xié)議（1）返回格式為默認為xml,如果http請求返回500錯誤，務(wù)

2、必在 請求頭 Accept加上application/xml ;如需返回json 格式，請把 http 請求頭中的 Accept 改為 application/json;charset=UTF-8 。（2）下單操作為異步請求，報文返回成功，則表示受理成功，具體 充值是否成功，則需要我方發(fā)起異步通知，或者下游發(fā)起查詢請求來 判斷。3、簽名和安全加密方式為MD5。將請求參數(shù)中的各個鍵值對按照key的字符串 順序升序排列（自然序），value拼成一串之后最后加上密鑰組成字 符串，取utf8字節(jié)后再做md5加密（32位小寫）。privateKey（密鑰）由充值平臺方分配，請妥善保存。上線之前請 告知充

3、值平臺方技術(shù)，請求服務(wù)器IP列表，通過IP白名單加強交 易安全。4、接口說明功能接口類型說明直充直充接口http 異步異步對話費進行供貨訂單結(jié)果查詢接口http同步根據(jù)合作方的流水號，查詢訂單信息。異步通知接口http同步我方訂單成功還是失敗，通知合作方。賬號余額查詢合作商賬號余額查詢接口http同步獲取賬戶內(nèi)余額等信息4.1參數(shù)的獲取1、找商務(wù)人員獲取用戶編號（userid ）、下單地址、privateKey以 及商品編碼。2、提供回調(diào)地址及IP給商務(wù)人員綁定4.2充值接口請求（系統(tǒng)間請求）目的URLhttp/ 下單地址 /unicomAync/buy.do字段名必填說明userid是合作方

4、用戶編號（充值平臺方提供）itemid是商品編號（充值平臺方提供）amt是購買數(shù)量uid是充值賬號serialno是合作方商戶系統(tǒng)的 流水號，全局唯一（不能重復(fù)使用）dtCreate是合作方交易時間（也可以是訂單創(chuàng)建時間，格式為：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>注：此處返回“交易成功”，表示受理成功，并不代表，充值成功，下游代理商 需要通過異步通知接口，獲取發(fā)起查詢請求來確保充值是否成功。A、md5力口密(32位小寫)。R MD5(dtCreate itemId serialno uid userId key)順序G參數(shù)用戶名是否有空格4.3查詢訂單接口請求（系統(tǒng)間請求）目的URLhttp/下單地址 /unicomAy

8、nc/queryBizOrder.do字段名必填說明userId是合作方用戶編號（充值平臺方提供）serialno是合作方商戶系統(tǒng)的流水號，全局唯一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 > / 購買數(shù)量<status>2</status> /0或者1處理中2成功3失敗4充值鎖定中(是處理中)9未確認(也是處理中)<statusDesc> 成功 </statusDesc><itemId>1001&l

10、t;/ itemId ><gmtCreate>20140301 00:00:00</gmtCreate> /訂單創(chuàng)建時間<gmtModify>20140301 00:00:00</ gmtModify > / 交易完成時間</data></response>4.4異步通知接口請求（系統(tǒng)間請求）目的URL合作方提供的回調(diào) URL字段名必填說明userId是合作方用戶編號（充值平臺方提供）bizId是業(yè)務(wù)編號ejId是充值平臺方訂單號downstreamSerialno是合作方商戶系統(tǒng)的流水號status是狀態(tài)2是成功3

11、是失敗sign是簽名(MD5) sign=MD5(bizId+downstreamSerialno+ejId+status +userId + privatekey );異步回調(diào)（采用GET!f式）：http:/xxxxxxx/xxx?userId=1&bizId=200&ejId=123188&downstreamSerialno= 123188&status=2&sign=3945c4cb677e0d39cea1765b015dc237返回success注意：這里下游用戶接受到異步回調(diào)，必須返回字符：success（小寫）, 如果沒有返回，將會繼續(xù)進

12、行通知回調(diào)，最多回調(diào)3次，間隔10秒。4.5余額查詢接口請求（系統(tǒng)間請求）目的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、報文狀態(tài)說明5.1訂購接口說明字段名code說明STATUSstatussuccess表小父易成功。statusfailed表小交勿失敗。CODEcode00受理成功。（具體是否充值成功通過回調(diào)或者查詢來判斷）code10缺少參數(shù)，或者參數(shù)類型錯誤code11校驗碼驗證失敗code12白名單校驗失敗code20商品狀態(tài)相關(guān)錯誤code21商品價格錯誤code22訂單相關(guān)錯誤code23流水號重復(fù)code25手機歸屬地錯誤code28黑名單相關(guān)錯誤code30上游供貨失敗code31上游供貨超時（如果是該狀態(tài)，請不要確認本次購買是失敗的， 因 為是網(wǎng)絡(luò)讀寫超時了，需要通過對賬，或者人工來處理本次交易）code40合作方賬號類型或者狀態(tài)錯誤code41合作方資金賬戶錯誤code42合作方余額不足等錯誤code43合作方支付錯誤code44合作方?jīng)]有該業(yè)務(wù)權(quán)限code50系統(tǒng)異常code51交易繁忙，上游供貨繁忙。根據(jù)code來判斷，code00表示受理成功，code31以及文檔外的 作未確認，其他作