云网支付网关技术接口手册v12.doc

云网支付@网技术手册 1 简 介 2 1.1 目的 2 1.2 本手册适用对象 2 1.3 开发调试流程综述 2 1.4 技术支持 3 2 安全控制 3 3 在线支付接口开发说明 3 3.1 测试接口说明 3 3.1.1 签名测试模块： 3 3.1.2 下订单测试模块： 4 3.1.3 支付成功提货测试模块： 4 3.1.4 支付网关整体测试流程模块： 4 3.2 实时通知商户支付结果方式的实现 5 3.2.1 商户向云网支付网关提交支付请求信息 6 3.2.2 支付网关将支付结果信息传给商户的接口 7 3.2.3 两种支付结果通知方式的说明： 8 服务器间通知方式（云网强烈建议用户采用此方式）： 8 普通通知方式： 9 3.2.4 在开发技术接口时还需注意以下方面: 9 4 商户订单自助查询系统 10 4.1 商户向云网网关提交订单查询信息 10 4.2 2.网关将查询结果信息传给商户的接口： 11 5 附录一：支付银行列表 12 6 附录二：技术接口范例代码说明 13  简 介 中国目前电子商务发展日趋成熟，电子商务网站越来越多，但是统一的支付平台还不是很成熟，基于这种环境，有必要建立一套完整的支付体系。本支付系统集成各个大银行的支持，提供给商家一个统一的平台，方便商户使用，能够及时的反应支付结果信息。 遵循“专业、安全、便捷目的本手册的主要目的是帮助商户熟练掌握的交易流程、，并能方便地与商户系统集成。对象本手册的用对象为商户的网上应用开发人员、维护人员和管理人员，他们应具有如下基本知识： 熟悉Microsoft Windows/NT、Windows9x、Windows 2000、Windows 、Windows HP-UX、AIX、SUN Solaris、Linux、BSD等操作系统； 熟悉上述系统的网站设置和网页制作方法； 熟悉标准CGI（Common Gateway Interface）或ASP（Active Server Pages）或ISAPI的开发方法或PHP或JAVA； 了解一般信息安全的基本概念。商户与完成所有商务手续后，可进入阶段。详细过程如下： /admin/），在管理首页获得商户的“支付密钥”，该密钥作MD5加密时，该密钥最初生成是在商户申请完成时由系统自动生成，在商户管理后台可以修改； 参照进行联网调试商户人员熟悉商户正式上线技术支持有关的任何问题，请邮编100080 电话：0102 支付网关事业部 Email：serv@ 安全控制 网上交易的传输安全控制手段采用SSL(Secure Socket Layer)，SSL是一种被广泛使用的INTERNET传输加密标准。客户端的浏览器发送CGI请求时使用https协议，所有用https发送的请求以及Web Server返回的结果都会自动使用SSL加密。 在线支付接口开发说明 测试接口说明 测试接口是把整个在线支付接口流程拆分为四个部分，分步骤进行开发测试，这样可有效缩短您开发技术接口的时间。 签名测试模块 下订单测试模块 支付成功提货测试模块 支付网关整体测试模块 签名测试模块： 测试目的：测试商户端的MD5加密结果和云网端进行MD5加密结果是否一致； 测试地址：/purchase/cnpaygate/testport/port_test31.asp 传递参数： 源串：testStr MD5加密结果串：signStr 参数说明： testStr是未进行MD5加密前的一个字符串 signStr是对testStr串进行MD5加密后的结果串，提交到测试路径时，先后顺序可变。 例如：/purchase/cnpaygate/testport/port_test31.asp?testStr=aderutyighsignStr=fe2aa1087c441ce9d8b4b3a378795532 下订单测试模块： 测试目的：测试商户端的订单信息是否能被云网网关系统正确接收； 测试路径：/purchase/cnpaygate/testport/port_test11.asp 测试说明：商户端需要提供以下信息：c_mid、c_order、c_name、c_address、c_tel、c_post、c_orderamount、c_ymd、c_moneytype、c_retflag、c_returl、c_signstr、c_memo1、c_memo2、paygate、c_email（各项具体含义详见下文，3.3节有详细描述），其中c_signstr是采用MD5对以下字符串：c_mid、c_order、c_orderamount、c_ymd、c_moneytype、c_retflag、c_returl、c_paygate、c_memo