新一代商户接入手册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 页

http://www.ChinaPay.com Chinapay新一代商户接入手册

3.2 运行及开发环境

商户可根据自己的实际情况，选用合适的开发平台和运行平台。ChinaPay将提供对应的NetPayClient版本。目前ChinaPay的NetPayClient有如下几种：

? ? ? ?

NetPayClient for Java （以JAR的方式提供） NetPayClient for Win32 （以DLL方式提供） NetPayClient for （以.class.php方式提供） NetPayClient for C (以.so或.a的方式提供)

3.3 术语

电子商务 Electronic Commerce是指通过信息网络以电子数据信息流通的方式在全世界范围内进行并完成的各种商务活动、交易活动、金融活动和相关的综合服务活动。

网络贸易 指在网络平台基础上直接进行在线贸易(Trade Online)，利用数字化技术将企业、海关、运输、金融、商检和税务等有关部门有机连接起来，实现从浏览、洽谈、签约、交货到付款等全部或部分业务自动化处理。网络贸易由信息共享、订购、支付、执行、服务与支持5个部分组成，每个部分在网络贸易中都各自承担了不同的任务。

B2C(Business to Consumer) 指企业与消费者之间的电子商务。这是消费者利用因特网直接参与经济活动的形式，类同于商业电子化的零售商务。目前，在因特网上有许许多多各种类型的虚拟商店和虚拟企业，提供各种与商品销售有关的服务。

B2B(Business to Business) 指企业与企业间的电子商务。企业可以使用因特网或其它网络对每笔交易寻找最佳合作伙伴，完成从订购到结算的全部交易行为，包括向供应商订货、签约、接受发票和使用电子资金转移、信用证、银行托收等方式进行付款，以及在商贸过程中发生的其它问题，如索赔、商品发送管理和运输跟踪等。

商户 具有电子商务功能的商店和企业。

银行卡 商业银行所发行的储蓄卡、信用卡、储值卡、企业购物卡、购物联名卡、虚拟电子卡等支付工具。

持卡人 银行卡的拥有者。

网上支付密码 数字串。发卡行用于鉴别网上持卡人身份，具体产生方法、使用范围和管理规范见各发卡行\业务规范\。

发卡行 具有发行银行卡功能的商业银行。

开户行 指持卡人卡账户或企业资金账户所在的商业银行。

SSL(Secure Socket Layer) 是一种基于网络传输层的安全网络传输协议，实现客户端与服务器端间的数据安全传递。

第 5 页 共 35 页

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库新一代商户接入手册V2.7在线全文阅读。