NetPayClient用户手册
（Version: 2.5.2）
上海银联电子支付服务有限公司
地址：延安西路2299号 上海世贸商城大厦19楼1901-1905室 (200336) Tel: (86-021)52504528 Fax: (86-021)62361165 Website: http://www.ChinaPay.com
?Copyright 2004.08 ChinaPay e-Payment Service Co.,Ltd. All rights reserved
http://www.ChinaPay.com NetPayClient用户手册
目 录
1. 2.
ChinaPay简介 ......................................................................................................................... 3 前言........................................................................................................................................... 3 2.1. 目的 ............................................................................................................................... 3 3. 总述........................................................................................................................................... 3
3.1. 使用对象 ....................................................................................................................... 3 3.2. 运行及开发环境 ........................................................................................................... 4 3.3. 术语 ............................................................................................................................... 4 3.4. 基本概念 ....................................................................................................................... 5
3.4.1. 公钥密码体系(Public-key Cryptography) ........................................................ 5 3.4.2. 隐秘钥密码体系(Secret-key Cryptography) .................................................... 6 3.4.3. 摘要算法 ........................................................................................................... 6 3.4.4. 数字签名 ........................................................................................................... 7 3.4.5. 数字信封 ........................................................................................................... 8 3.5. 客户端NetPayClient在各系统下的安装及调用 ....................................................... 9
3.5.1. 说明 ................................................................................................................... 9 3.5.2. NetPayClient for Java 使用说明 ...................................................................... 9 3.5.3. NetPayClient for Win32使用说明 ................................................................. 12 3.5.4. NetPayClient for C使用说明 ......................................................................... 17
4. 支付......................................................................................................................................... 21
4.1. 目标 ............................................................................................................................. 21 4.2. 交易流程 ..................................................................................................................... 21 4.3. 接入方法 ..................................................................................................................... 22
4.3.1. 接入地址 ......................................................................................................... 22 4.3.2. 接入版本 ......................................................................................................... 22
5. 退款......................................................................................................................................... 26
5.1. 目标 ............................................................................................................................. 26 5.2. 处理流程 ..................................................................................................................... 26 5.3. 接入方法 ..................................................................................................................... 26
5.3.1. 接入地址 ......................................................................................................... 26 5.3.2. 接入版本 ......................................................................................................... 26
6. 查询......................................................................................................................................... 29
6.1. 目标 ............................................................................................................................. 29 6.2. 处理流程 ..................................................................................................................... 29 6.3. 接入方法 ..................................................................................................................... 29
6.3.1. 接入地址 ......................................................................................................... 29 6.3.2. 接入版本 ......................................................................................................... 29
附录A 常见接入问题及解答 ....................................................................................................... 31 附录B 应答码说明 ....................................................................................................................... 31
ChinaPay交易状态码 ............................................................................................................ 31 NetPayClient API函数错误代码 ........................................................................................... 32 查询，单笔退款错误代码 ..................................................................................................... 32
第 2 页 共 27 页
http://www.ChinaPay.com NetPayClient用户手册
1. ChinaPay简介
CHINAPAY 致力于发展中国金融电子支付服务。
银联电子支付服务有限公司（ChinaPay）是中国银联控股的银行卡专业化服务公司，拥有面向全国的统一支付平台，主要从事以互联网等新兴渠道为基础的网上支付、企业B2B账户支付、电话支付、网上跨行转账、网上基金交易、企业公对私资金代付、自助终端支付等银行卡网上支付及增值业务，是中国银联旗下的网络方面军。
ChinaPay依托中国银联全国统一的跨行信息交换网络，在人民银行及中国银联的业务指导和政策支持下，致力于银行卡受理环境的建设和银行卡业务的推广，将先进的支付科技与专业的金融服务紧密结合起来，通过业务创新形成多元化的支付服务体系，为广大持卡人和各类商户提供安全、方便、快捷的银行卡支付及资金结算服务。公司充分利用中国银联全国性的品牌、网络、市场等优势资源，整合银联体系的系统资源、银行资源、商户资源和品牌影响力，实现强强联合、资源共享和优势互补。
经过数年的开拓发展，ChinaPay拥有了雄厚的技术开发力量及丰富的业务拓展经验，为网上购物、金融、民航、旅游、彩票、移动通讯等行业领域提供了先进的支付系统解决方案，并积累了丰富的工程项目实施经验。
2. 前言
ChinaPay商户支付接口接入为ChinaPay商户会员提供完善的网上支付解决方案，让商户更快捷、方便和安心的开展网上交易。目前ChinaPay商户支付接口接入提供如下功能：
? 商户消费交易的银行支付 ? 商户针对成功消费交易的退款 ? 商户对已有交易(消费)查询
2.1. 目的
本手册的主要目的是帮助ChinaPay商户会员使用我们提供的支付服务接口方式。本文分为四大部分：
总述：介绍文档中出现的一些基本概念，以及ChinaPay的客户端插件的介绍和使用。 支付：介绍支付的接入需要提供的数据域和内容。 退款：介绍退款的接口方式接入的数据域和内容。 查询：介绍交易查询接口方式的使用。
3. 总述
3.1. 使用对象
本手册的使用对象为ChinaPay商户会员的网上应用开发人员、维护人员和管理人员，
第 3 页 共 27 页
http://www.ChinaPay.com NetPayClient用户手册
他们应具有如下之一或者几项基本知识：
熟悉Microsoft Windows/NT、Windows9x、Windows 2000、HP-UX、AIX、SUN Solaris、Linux、BSD等操作系统；
熟悉上述系统上的网站设置和网页制作方法；
熟悉标准CGI（Common Gateway Interface）或ASP（Active Server Pages）或ISAPI的开发方法或PHP或JAVA；
了解一般信息安全的基本概念。
3.2. 运行及开发环境
商户可根据自己的实际情况，选用合适的开发平台和运行平台。ChinaPay将提供对应的NetPayClient版本。目前ChinaPay的NetPayClient有如下几种：
? NetPayClient for Java （以JAR的方式提供，用于Java平台的开发）
? NetPayClient for Win32 （以DLL方式提供，用于Windows系统上的开发） ? NetPayClient for C (以.so或.a的方式提供，用于类UNIX系统上的开发)
3.3. 术语
电子商务 Electronic Commerce是指通过信息网络以电子数据信息流通的方式在全世界范围内进行并完成的各种商务活动、交易活动、金融活动和相关的综合服务活动。
网络贸易 指在网络平台基础上直接进行在线贸易(Trade Online)，利用数字化技术将企业、海关、运输、金融、商检和税务等有关部门有机连接起来，实现从浏览、洽谈、签约、交货到付款等全部或部分业务自动化处理。网络贸易由信息共享、订购、支付、执行、服务与支持5个部分组成，每个部分在网络贸易中都各自承担了不同的任务。
B2C(Business to Consumer) 指企业与消费者之间的电子商务。这是消费者利用因特网直接参与经济活动的形式，类同于商业电子化的零售商务。目前，在因特网上有许许多多各种类型的虚拟商店和虚拟企业，提供各种与商品销售有关的服务。
B2B(Business to Business) 指企业与企业间的电子商务。企业可以使用因特网或其它网络对每笔交易寻找最佳合作伙伴，完成从订购到结算的全部交易行为，包括向供应商订货、签约、接受发票和使用电子资金转移、信用证、银行托收等方式进行付款，以及在商贸过程中发生的其它问题，如索赔、商品发送管理和运输跟踪等。
商户 具有电子商务功能的商店和企业。
银行卡 商业银行所发行的储蓄卡、信用卡、储值卡、企业购物卡、购物联名卡、虚拟电子卡等支付工具。
持卡人 银行卡的拥有者。
网上支付密码 数字串。发卡行用于鉴别网上持卡人身份，具体产生方法、使用范围和管理规范见各发卡行\业务规范\。
第 4 页 共 27 页
http://www.ChinaPay.com NetPayClient用户手册
发卡行 具有发行银行卡功能的商业银行。
开户行 指持卡人卡账户或企业资金账户所在的商业银行。
SSL(Secure Socket Layer) 是一种基于网络传输层的安全网络传输协议，实现客户端与服务器端间的数据安全传递。
3.4. 基本概念
随着计算机网络及因特网技术的飞速发展，为了降低成本、提高效率、拓展新的市场领域和改善服务质量，越来越多企业、商户及金融机构纷纷将他们的传统业务逐渐地向网上迁移。因特网已不仅仅是一个单纯的信息交换网络，已逐渐发展为一个全球性的商务网络，所以网络安全必然是人们关注的焦点。网络安全就是运用各种技术手段，解决如下四个方面的问题：
? 私有性-保证通信信息在网络传输过程中不能被第三方窃听者破译； ? 完整性-接受方能检测出信息在网络传输过程中是否被篡改； ? 确认性-接受方能有效地对信息发送方的身份进行认证；
? 不可否认性-接受方一旦接受到发送方的有效信息，发送在事后无法予以抵赖。 针对上述问题，现代密码学给出了完整的答案。其中加密算法解决了信息的私有性，摘要算法用于数据完整性检查， 而签名算法实现了信息来源的认证及防止发送方的事后抵赖。现代密码学主要分为公钥密码体系和隐秘钥密码体系，本章节就一些基本概念进行简要性的介绍。
3.4.1. 公钥密码体系(Public-key Cryptography)
公钥密码体系，又称非对称密码体系。它使用二个密钥，一个用于加密信息，另一个用于解密信息。 这二个密钥间满足一定数学关系，以至用二个密钥中的任何一个加密的数据，只能用另外一个进行数据解密。每个用户拥有二个密钥，一个被称之为公钥，另一个被称之为私钥，并将公钥分发给其它用户。由于这二个密钥间的数学关系， 任何收到该用户公钥的其它用户可以保证发送用此公钥进行加密的数据只有该用户用自己的私钥才能进行解密。 当然此项保证是建立在用户私钥的私有性基础之上。目前最著名的公钥密码算法为RSA算法，它是由Rivest、Shamir和Adleman共同发明的。见图示：
第 5 页 共 27 页