第2章支付平台接口-易充小额支付联盟.doc

中国电信118电子商务平台 电话小额支付 合作商户支付接口规范 版本 2.0 浙江兰创通信有限公司 2007年6月 修订历史 日期 内容 版本 修订人 2007-6-25 创建文档 1.0 邱劲松 2007-6-27 补充包月业务处理 1.0 邱劲松 2007-7-20 修正ASP示例代码，补充XML示例文件 1.0 邱劲松 2007-8-7 补充Java示例代码 1.0 邱劲松 2010-5-17 补充代理商接入代码 1.1 沈 毅 2010-5-18 支付请求怎间cpdata自定义字段 2.0 陆 刚 2010-5-18 添加后台支付结果通知 2.0 陆 刚 2010-6-30 添加支付请求时间戳字段 2.1 陆 刚 2010-6-30 支付请求增加代理商ID 2.1 陆 刚 2010-6-30 简化支付请求参数，去掉OP字段，仅支持支付请求 2.1 陆 刚 2010-6-30 增加单独“查询支付结果”接口 2.1 陆 刚 2010-6-30 增加单独“支付撤销”接口 2.1 陆 刚 2010-6-30 增加包月产品支付接口 2.1 陆 刚 目 录 第1章 总体描述 4 1.1 业务流程 4 1.2 通信模型 4 1.3 合作商户的管理 5 第2章 支付平台接口 6 2.1 支付请求 6 2.2 前台支付结果通知 7 2.2.1 参数描述 7 2.2.2 返回数据格式 8 2.2.3 参数值说明 8 2.3 查询支付结果请求 9 2.4 支付撤销 10 2.5 包月支付请求 11 2.6 后台支付结果通知 12 第3章 支付过程实现步骤 13 第4章 包月产品的支付过程 14 第5章 支付结果通知说明 15 第6章 签名的实现过程 16 6.1 签名的方法 16 6.2 签名的算法 16 6.3 签名的.NET代码 17 6.4 签名的Java代码 21 6.5 测试用的密钥/公钥XML文件 25 总体描述 业务流程 如图所示，用户在合作商户的网站上进行购物选择，直到决定付款时，用户点击电话支付按钮，然后用户可以看到由电话支付平台给出的，提示用户如何进行电话支付的操作提示。用户根据提示拨打指定电话号码，在听到需要支付的交易信息时，按确认键，即完成支付。 通信模型 电话支付网关与合作网站之间采用HTTP通信，采用短连接。电话支付网关为服务器，合作网站为客户端。 电话支付网关的URL地址：/phonePay 当用户要求使用电话支付时，合作网站向该地址发起支付请求，采用HTTP POST方式，并携带请求数据。 因为合作网站和电话支付网关之间并没有传递类似用户密码之类的需要防止窃听的数据，所以可不必对数据进行加密。 但为了确保请求确实来自授权的合作网站，以及合作网站能够确认数据来自电话支付网关，请求和响应数据必须带有数字签名，签名算法采用RSA，密钥由电话支付平台分配，合作网站自行下载。 通信过程如图所示： 合作网站的交易支付请求都是通过用户的浏览器转交的，为了防止出现恶意的信息，合作网站必须对相关支付参数进行签名。 合作商户的管理 合作网站成为电话支付平台的合作商户之前，必须得到电话支付平台的资质审核，登记步骤如下： 合作网站首先登录到电话支付平台的网页，填写相关注册信息 电话支付平台对合作网站进行审核 审核通过后，给合作网站分配商户编号和密码 合作网站登录电话支付平台的网页，下载密钥和证书 合作网站的负责人可以凭密码登录到电话支付网关的网页，进行结算记录的查询。 密钥是以数字证书的形式保存在文件中的，合作网站应妥善保管该文件，避免泄露给其他人，如果发生泄漏，应通知电话支付网关，予以撤销，并重新申请。 为提高安全性，合作商户可以要求电话支付网关对合作网站的IP地址进行授权，仅登记的IP地址可以登录。 支付平台接口 支付请求 实现方：电话支付平台 调用方：客户浏览器/合作网站 用 途：合作网站通过客户浏览器通知电话支付平台启动电话支付过程 调用地址：/phonepay.aspx?参数串 参数串： agentid=unitid=transidbjid=1234money=12retweb=http://yourweb/transresult.aspxusername=1001cpdata=task=3|id=4unitid=12345sign=mudxqwexudxadjs8idkslq 参数描述： op： 请求类型,固定值为1 【必选参数】 unitid： 商户编码 【必选参数】 transid：交易流水号，合作网站生成，网站内唯一【必选参数】 objid：交易商品编码 【必选参数】 objname:: 产品名称， 【