咪咕互娛網(wǎng)頁陽光計(jì)劃支付接入規(guī)范_V14

1、咪咕互娛網(wǎng)頁陽光計(jì)劃支付接入規(guī)范2016年10月V 1.4修訂記錄日期修訂版本修改章節(jié)修改描述作者2015-10-121.0初版2016-02-增加防盜鏈功能2016-05-031.22.2第三方直付增加用戶身份標(biāo)識uId參數(shù)2016-08-051.32.2集團(tuán)陽光計(jì)劃業(yè)務(wù)增加內(nèi)容Id參數(shù)2016-10-201.42.1/2.2/3.1/3.2修改陽光計(jì)劃接口規(guī)范1 介紹1.1 編寫目的本文檔闡述了手機(jī)網(wǎng)頁支付平臺的接入方案，涉及支付平臺接入的流程及相關(guān)業(yè)務(wù)流程與要求、接口定義等方面，作為合作方和H5支付開發(fā)平臺共同遵守的接口開發(fā)標(biāo)準(zhǔn)。1.2 術(shù)語定義縮略語縮略語全稱中文解

2、釋MD5Message-Digest Algorithm 5消息摘要算法第五版2 點(diǎn)播接口2.1 基本規(guī)范n 請求與響應(yīng)消息統(tǒng)一采用UTF-8編碼方式。n 請求參數(shù)默認(rèn)采用標(biāo)準(zhǔn)HTTP GET/POST方式。n 為不影響H5游戲頁面，建議接入時(shí)采用打開一個(gè)新的頁面窗口的方式。2.2 調(diào)用方式n 請求地址:5443/h5pay/api/ygPayn 請求參數(shù)定義序號字段是否可選 是否計(jì)入摘要含義1spCode必選是游戲CP/SP ID2channelCode必選是計(jì)費(fèi)渠道代碼（8位線上渠道）目前渠道id統(tǒng)一傳“XXXXXX”3productDescribe必選是商品信息描述-計(jì)費(fèi)點(diǎn)或包月業(yè)務(wù)名稱

3、4contentCode必選是計(jì)費(fèi)代碼（呈現(xiàn)ID）5contentName可選是內(nèi)容信息描述6consumeCode必選是道具代碼7cpparam可選是游戲CP/SP透傳參數(shù)，合作伙伴可以將自定義訂單號、自定義渠道來源、合作伙伴用戶標(biāo)識等存入此字段，在計(jì)費(fèi)回調(diào)接口中我們會將該字段隨著計(jì)費(fèi)結(jié)果回傳，8redirectURL可選是支付成功頁面跳轉(zhuǎn)地址9signature必選否請求摘要10uId可選是用戶身份標(biāo)識11contentId必選是內(nèi)容Id，陽光計(jì)劃業(yè)務(wù)必選12notifyURL可選是13monthStatus必選是是否包月：1為包月，0為點(diǎn)播14serviceID必選是業(yè)務(wù)編碼15toke

4、n可選是當(dāng)token填寫時(shí)，sourceID、appType 、appID、version為必填，自有門戶使用16sourceID可選是自有門戶使用17appID可選是自有門戶使用18appType可選是自有門戶使用19version可選是自有門戶使用n 參數(shù)補(bǔ)充說明productDescribe：商品信息描述，供支付頁面展示使用，具體展示內(nèi)容由CP/SP側(cè)提供。contentName：業(yè)務(wù)信息，供支付頁面展示使用，具體展示內(nèi)容由CP/SP側(cè)提供。redirectURL：游戲CP/SP支付成功頁面跳轉(zhuǎn)地址，供手機(jī)網(wǎng)頁支付成功頁跳轉(zhuǎn)使用。cpparam：游戲CP/SP透傳參數(shù)。signature

5、：請求摘要，判斷請求合法性。3 包月接口3.1 基本規(guī)范n 請求與響應(yīng)消息統(tǒng)一采用UTF-8編碼方式。n 請求參數(shù)默認(rèn)采用標(biāo)準(zhǔn)HTTP GET/POST方式。n 為不影響H5游戲頁面，建議接入時(shí)采用打開一個(gè)新的頁面窗口的方式。3.2 調(diào)用方式n 請求地址n :5443/pay/api/ygPay:5443/h5pay/api/YGpayn 請求參數(shù)定義序號字段是否可選 是否計(jì)入摘要含義1spCode必選是游戲CP/SP ID2channelCode必選是計(jì)費(fèi)渠道代碼（8位線上渠道）目前渠道id統(tǒng)一傳“XXXXXX”3productDescribe必選是商品信息描述-計(jì)費(fèi)點(diǎn)或包月業(yè)務(wù)名稱4con

6、tentCode必選是計(jì)費(fèi)代碼（呈現(xiàn)ID）5contentName可選是內(nèi)容信息描述6cpparam必選是游戲CP/SP透傳參數(shù)，合作伙伴可以將自定義訂單號、自定義渠道來源、合作伙伴用戶標(biāo)識等存入此字段，在計(jì)費(fèi)回調(diào)接口中我們會將該字段隨著計(jì)費(fèi)結(jié)果回傳7redirectURL可選是支付成功頁面跳轉(zhuǎn)地址8signature必選否請求摘要9uId可選是用戶身份標(biāo)識10contentId必選是內(nèi)容Id，陽光計(jì)劃業(yè)務(wù)必選11notifyURL可選是12monthStatus必選是是否包月：1為包月，0為點(diǎn)播13serviceID必選是業(yè)務(wù)編碼或套餐包編碼14token可選是當(dāng)token填寫時(shí)，sourc

7、eID、appType 、appID、version為必填，自有門戶使用15sourceID可選是自有門戶使用16appID可選是自有門戶使用17appType可選是自有門戶使用18version可選是自有門戶使用4 終端請求安全機(jī)制4.1防盜鏈計(jì)費(fèi)密鑰參數(shù)為了提高H5支付接入的安全級別，在SP/CP接入支付平臺的時(shí)候，必須將密鑰參數(shù)拼接到排完序的請求參數(shù)末尾進(jìn)行簽名生成請求摘要。密鑰參數(shù)由IGOP平臺配置，分配給合作方；同時(shí)同步給H5支付平臺，通過請求參數(shù)呈現(xiàn)代碼獲取一一對應(yīng)關(guān)系。密鑰參數(shù)不在計(jì)費(fèi)請求中傳輸。4.2摘要生成規(guī)則調(diào)用API 時(shí)需要對請求參數(shù)進(jìn)行簽名驗(yàn)證，終端接入服務(wù)器會對該請求

8、參數(shù)進(jìn)行驗(yàn)證是否合法的。方法如下：請求參數(shù)：String parameters=" spCode=60000000001"," channelCode=60000000002"," productDescribe=ABC"," contentCode=60000000003"," contentName=EDF"," consumeCode=60000000004"," price=50"," cpparam=1234567890123456&q

9、uot;," redirectURL="," uId=1117306071"," contentId=605820079498"對數(shù)組里的每一個(gè)值從a到z的順序排序,若遇到相同首字母,則看第二個(gè)字母,以此類推.排序完成之后,再把所有數(shù)組值以“&”字符連接起來,如：channelCode=60000000002&consumeCode=60000000004&contentCode=60000000003&contentId=605820079498&contentName=EDF&cpp

10、aram=1234567890123456&price=50&productDescribe=ABC&redirectURL=&spCode=60000000001&uId=1117306071在該字符串基礎(chǔ)上末尾拼上密鑰參數(shù)：channelCode=60000000002&consumeCode=60000000004&contentCode=60000000003&contentId=605820079498&contentName=EDF&cpparam=1234567890123456&price=50&productDescribe=ABC&redirectURL=&spCode=60000000001&uId=1117306071&appKeyValue這串字符串便是待簽名字符串S，采用MD5算法將S的UTF-8編碼字節(jié)生成摘要即toHex(MD5(S.getBytes("UTF-8")簽名注意事項(xiàng):Ø 沒有值的參數(shù)無需傳遞,也無需包含到待簽名摘要數(shù)據(jù)中;Ø 簽名時(shí)將字符轉(zhuǎn)化成字節(jié)流時(shí)指定的字符集必須為UTF-8;Ø 根據(jù)