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

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

2、釋MD5Message-Digest Algorithm 5消息摘要算法第五版2 點(diǎn)播接口2.1 基本規(guī)范n 請(qǐng)求與響應(yīng)消息統(tǒng)一采用UTF-8編碼方式。n 請(qǐng)求參數(shù)默認(rèn)采用標(biāo)準(zhǔn)HTTP GET/POST方式。n 為不影響H5游戲頁(yè)面，建議接入時(shí)采用打開(kāi)一個(gè)新的頁(yè)面窗口的方式。2.2 調(diào)用方式n 請(qǐng)求地址:5443/h5pay/api/ygPayn 請(qǐng)求參數(shù)定義序號(hào)字段是否可選 是否計(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透?jìng)鲄?shù)，合作伙伴可以將自定義訂單號(hào)、自定義渠道來(lái)源、合作伙伴用戶標(biāo)識(shí)等存入此字段，在計(jì)費(fèi)回調(diào)接口中我們會(huì)將該字段隨著計(jì)費(fèi)結(jié)果回傳，8redirectURL可選是支付成功頁(yè)面跳轉(zhuǎn)地址9signature必選否請(qǐng)求摘要10uId可選是用戶身份標(biāo)識(shí)11contentId必選是內(nèi)容Id，陽(yáng)光計(jì)劃業(yè)務(wù)必選12notifyURL可選是13monthStatus必選是是否包月：1為包月，0為點(diǎn)播14serviceID必選是業(yè)務(wù)編碼15toke

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

5、：請(qǐng)求摘要，判斷請(qǐng)求合法性。3 包月接口3.1 基本規(guī)范n 請(qǐng)求與響應(yīng)消息統(tǒng)一采用UTF-8編碼方式。n 請(qǐng)求參數(shù)默認(rèn)采用標(biāo)準(zhǔn)HTTP GET/POST方式。n 為不影響H5游戲頁(yè)面，建議接入時(shí)采用打開(kāi)一個(gè)新的頁(yè)面窗口的方式。3.2 調(diào)用方式n 請(qǐng)求地址n :5443/pay/api/ygPay:5443/h5pay/api/YGpayn 請(qǐng)求參數(shù)定義序號(hào)字段是否可選 是否計(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透?jìng)鲄?shù)，合作伙伴可以將自定義訂單號(hào)、自定義渠道來(lái)源、合作伙伴用戶標(biāo)識(shí)等存入此字段，在計(jì)費(fèi)回調(diào)接口中我們會(huì)將該字段隨著計(jì)費(fèi)結(jié)果回傳7redirectURL可選是支付成功頁(yè)面跳轉(zhuǎn)地址8signature必選否請(qǐng)求摘要9uId可選是用戶身份標(biāo)識(shí)10contentId必選是內(nèi)容Id，陽(yáng)光計(jì)劃業(yè)務(wù)必選11notifyURL可選是12monthStatus必選是是否包月：1為包月，0為點(diǎn)播13serviceID必選是業(yè)務(wù)編碼或套餐包編碼14token可選是當(dāng)token填寫(xiě)時(shí)，sourc

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

8、參數(shù)進(jìn)行驗(yàn)證是否合法的。方法如下：請(qǐng)求參數(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"對(duì)數(shù)組里的每一個(gè)值從a到z的順序排序,若遇到相同首字母,則看第二個(gè)字母,以此類(lèi)推.排序完成之后,再把所有數(shù)組值以“&”字符連接起來(lái),如：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):Ø 沒(méi)有值的參數(shù)無(wú)需傳遞,也無(wú)需包含到待簽名摘要數(shù)據(jù)中;Ø 簽名時(shí)將字符轉(zhuǎn)化成字節(jié)流時(shí)指定的字符集必須為UTF-8;Ø 根據(jù)