咪咕互娱网页阳光计划支付接入规范_V1.4详解.docx

咪咕互娱网页阳光计划支付接入规范2016年10月V 1.4修订记录日期修订版本修改章节修改描述作者2015-10-121.0初版2016-02-增加防盗链功能2016-08-051.32.2集团阳光计划业务增加内容Id参数2016-10-201.42.1/2.2/3.1/3.2修改阳光计划接口规范介绍编写目的本文档阐述了手机网页支付平台的接入方案，涉及支付平台接入的流程及相关业务流程与要求、接口定义等方面，作为合作方和支付开发平台共同遵守的接口开发标准。术语定义缩略语缩略语全称中文解释MD5Message-Digest Algorithm 5消息摘要算法第五版点播接口基本规范请求与响应消息统一采用UTF-8编码方式。请求参数默认采用标准HTTP GET/POST方式。为不影响游戏页面，建议接入时采用打开一个新的页面窗口的方式。调用方式请求地址:5443/h5pay/api/ygPay请求参数定义序号字段是否可选是否计入摘要含义1spCode必选是游戏CP/SPID2channelCode必选是计费渠道代码（8位线上渠道）目前渠道id统一传“XXXXXX”3productDescribe必选是商品信息描述-计费点或包月业务名称4contentCode必选是计费代码（呈现ID）5contentName可选是内容信息描述6consumeCode必选是道具代码7cpparam可选是游戏CP/SP透传参数，合作伙伴可以将自定义订单号、自定义渠道来源、合作伙伴用户标识等存入此字段，在计费回调接口中我们会将该字段随着计费结果回传，8redirectURL可选是支付成功页面跳转地址9signature必选否请求摘要10uId可选是用户身份标识11contentId必选是内容Id，阳光计划业务必选12notifyURL可选是13monthStatus必选是是否包月：1为包月，0为点播14serviceID必选是业务编码15token可选是当token填写时，sourceID、appType 、appID、version为必填，自有门户使用16sourceID可选是自有门户使用17appID可选是自有门户使用18appType可选是自有门户使用19version可选是自有门户使用参数补充说明productDescribe：商品信息描述，供支付页面展示使用，具体展示内容由CP/SP侧提供。contentName：业务信息，供支付页面展示使用，具体展示内容由CP/SP侧提供。redirectURL：游戏CP/SP支付成功页面跳转地址，供手机网页支付成功页跳转使用。cpparam：游戏CP/SP透传参数。signature：请求摘要，判断请求合法性。包月接口基本规范请求与响应消息统一采用UTF-8编码方式。请求参数默认采用标准HTTP GET/POST方式。为不影响游戏页面，建议接入时采用打开一个新的页面窗口的方式。调用方式请求地址:5443/pay/api/ygPay请求参数定义序号字段是否可选是否计入摘要含义1spCode必选是游戏CP/SPID2channelCode必选是计费渠道代码（8位线上渠道）目前渠道id统一传“XXXXXX”3productDescribe必选是商品信息描述-计费点或包月业务名称6cpparam必选是游戏CP/SP透传参数，合作伙伴可以将自定义订单号、自定义渠道来源、合作伙伴用户标识等存入此字段，在计费回调接口中我们会将该字段随着计费结果回传7redirectURL可选是支付成功页面跳转地址8signature必选否请求摘要9uId可选是用户身份标识11notifyURL可选是12monthStatus必选是是否包月：1为包月，0为点播13serviceID必选是套餐包编码14token可选是当token填写时，sourceID、appType 、appID、version为必填，自有门户使用15sourceID可选是自有门户使用16appID可选是自有门户使用17appType可选是自有门户使用18version可选是自有门户使用4 终端请求安全机制4.1防盗链计费密钥参数为了提高支付接入的安全级别，在SP/CP接入支付平台的时候，必须将密钥参数拼接到排完序的请求参数末尾进行签名生成请求摘要。密钥参数由IGOP平台配置，分配给合作方；同时同步给支付平台，通过请求参数呈现代码获取一一对应关系。密钥参数不在计费请求中传输。4.2摘要生成规则调用API 时需要对请求参数进行签名验证，终端接入服务器会对该请求参数进行验证是否合法的。方法如下：请求参数：String[] parameters={ spCode=60000000001, channelCode=60000000002, productDescribe=ABC, c