发布时间 : 星期日 文章新一代商户接入手册V2.7更新完毕开始阅读
新一代商户接入用户手册
（Version: 2.7）
修订历史记录
日期 20151014 20151021 20151118 20160105 20160118 20160214 20160301 20160506 版本 V2.0 V2.1 V2.2 V2.3 V2.4 V2.5 V2.6 V2.7 说明 修改应答数据签名验签的说明 增加插件包超链接及合并插件 更新.net插件，删除一条hosts配置 更新C语言部分及其他问题 更新文件验签部分示例代码及结算对账文件名 统一security.properties的描述，增加RiskData 更改运营中心电话 修改附录A 上海银联电子支付服务有限公司
地址：上海浦东新区东方路800号 宝安大厦29楼-30楼 (200122)
Tel: (86-021)60872088 Fax: (86-021)60872000 Website: http://www.ChinaPay.com ?Copyright 2010 ChinaPay e-Payment Service Co.,Ltd. All rights reserved
作者 初伟 初伟 初伟 初伟 初伟 初伟 初伟 初伟 http://www.ChinaPay.com Chinapay新一代商户接入手册
目录
1 ChinaPay简介.......................................................................................................................... 4 2 前言........................................................................................................................................... 4
2.1 目的 ........................................................................................................................... 4 3 总述........................................................................................................................................... 4
3.1 使用对象 ................................................................................................................... 4 3.2 运行及开发环境 ....................................................................................................... 5 3.3 术语 ........................................................................................................................... 5 3.4 NetPayClient的使用 .............................................................................................. 6
3.4.1 NetPayClient for Java 使用说明 ........................................................... 6 3.4.2 NetPayClient for PHP使用说明 ............................................................ 12 3.4.3 NetPayClient for .NET使用说明 .......................................................... 18 3.4.4 NetPayClient for C使用说明 ................................................................ 24
4 交易流程说明 ......................................................................................................................... 29
4.1 消费类交易流程 ..................................................................................................... 29 4.2 后续类交易流程 ..................................................................................................... 30 4.3 查询交易流程 ......................................................................................................... 31 4.4 对账处理流程 ......................................................................................................... 31 4.5 结算处理流程 ......................................................................................................... 31 5 数据类型定义 ......................................................................................................................... 31 6 消费类交易接口 ..................................................................................................................... 32
6.1 接入地址 ................................................................................................................. 32 6.2 请求报文 ................................................................................................................. 33 6.3 应答报文 ................................................................................................................. 35 7 后续类交易接口 ..................................................................................................................... 37
7.1 接入地址 ................................................................................................................. 37 7.2 请求报文 ................................................................................................................. 38 7.3 同步响应 ................................................................................................................. 40 7.4 应答报文 ................................................................................................................. 40 8 交易查询接口 ......................................................................................................................... 41
8.1 接入地址 ................................................................................................................. 41 8.2 请求报文 ................................................................................................................. 41 8.3 应答报文 ................................................................................................................. 42 9 对账接口 ................................................................................................................................. 43
9.1 概述 ......................................................................................................................... 43 9.2 通知商户的地址规范 ............................................................................................. 43
9.2.1 https方式 .................................................................................................. 43 9.2.2 ftp方式 ...................................................................................................... 44 9.3 对账文件名规则 ..................................................................................................... 44 9.4 商户对账文件格式（版本号：20150813） ......................................................... 44 10 网银支付结算接口 ......................................................................................................... 46
10.1 概述 ......................................................................................................................... 46
第 2 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
10.2 通知商户的地址规范 ............................................................................................. 46
10.2.1 https方式 .................................................................................................. 46 10.2.2 ftp方式 ...................................................................................................... 46 10.3 结算文件名规则 ..................................................................................................... 47 10.4 商户结算文件格式（版本号：20150813） ......................................................... 47
附录A 常见接入问题及解答 ........................................................................................ 48 附录B 应答码说明 ........................................................................................................ 49 附录C 支付机构代码 .................................................................................................... 58 ChinaPay商户安全加密控件 ........................................................................................ 61 14.1 JAVA版 .................................................................................................................... 61 14.2 PHP版 ...................................................................................................................... 61 14.3 .NET版 .................................................................................................................... 62 14.4 C语言版 .................................................................................................................. 62
11 12 13 14
第 3 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
1 ChinaPay简介
CHINAPAY 致力于发展中国金融电子支付服务。
银联电子支付服务有限公司（ChinaPay）是中国银联控股的银行卡专业化服务公司，拥有面向全国的
统一支付平台，主要从事以互联网等新兴渠道为基础的网上支付、企业B2B账户支付、电话支付、网上跨行转账、网上基金交易、企业公对私资金代付、自助终端支付等银行卡网上支付及增值业务，是中国银联旗下的网络方面军。
ChinaPay依托中国银联全国统一的跨行信息交换网络，在人民银行及中国银联的业务指导和政策支持下，致力于银行卡受理环境的建设和银行卡业务的推广，将先进的支付科技与专业的金融服务紧密结合起来，通过业务创新形成多元化的支付服务体系，为广大持卡人和各类商户提供安全、方便、快捷的银行卡支付及资金结算服务。公司充分利用中国银联全国性的品牌、网络、市场等优势资源，整合银联体系的系统资源、银行资源、商户资源和品牌影响力，实现强强联合、资源共享和优势互补。
经过数年的开拓发展，ChinaPay拥有了雄厚的技术开发力量及丰富的业务拓展经验，为网上购物、金融、民航、旅游、彩票、移动通讯等行业领域提供了先进的支付系统解决方案，并积累了丰富的工程项目实施经验。
2 前言
ChinaPay商户支付接口接入为ChinaPay商户会员提供完善的网上支付解决方案，让商户更快捷、方
便和安心的开展网上交易。目前ChinaPay商户支付接口接入提供如下功能：
? ? ?
商户消费交易的银行支付 商户针对成功消费交易的退款 商户对已有交易(消费)查询
2.1 目的
本手册的主要目的是帮助ChinaPay商户会员使用我们提供的支付服务接口方式。 3
总述
3.1 使用对象
本手册的使用对象为ChinaPay商户会员的网上应用开发人员、维护人员和管理人员，他们应具有如下之一或者几项基本知识：
熟悉Microsoft Windows/NT、Windows9x、Windows 2000、HP-UX、AIX、SUN Solaris、Linux、BSD等操作系统；
熟悉上述系统上的网站设置和网页制作方法；
熟悉标准CGI（Common Gateway Interface）或ASP（Active Server Pages）或ISAPI的开发方法或PHP或JAVA；
了解一般信息安全的基本概念。
第 4 页 共 35 页