银联电子支付服务有限公司（ChinaPay）接口

接口

需积分: 24 65 浏览量更新于2023-03-16 评论收藏 736KB DOC 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源评论

资源推荐

CHINAPAY 统一支付平台商户接入手册

（Version: 2.3.4 ）

上海银联电子支付服务有限公司

地址：上海浦东新区东方路 800 号宝安大厦 29 楼-30 楼 (200122)

Tel: (86-021)60872088 Fax: (86-021)60872000 Website: http://www.ChinaPay.com

http://www.ChinaPay.com 统一支付平台商户接入手册

日期版本修改人备注

2012-02-22 V2.3.4

胡建林 1. 增加“4.4 基本概念”章节；

2. 增加“4.5 客户端 NetPayClient 在各系统下的安装及

调用”章节；

3. 增加“16.3NetPayClient API 函数错误代码”章节。

2011-12-12 V2.3.3

王涛 1. 增加代扣网关 7008 的接口说明

2. 去掉业务配置接口

2011-7-07 V2.3.2

周永乐 1.修订结算文件格式

2011-7-06 V2.3.1

周永乐 1.修订对帐、结算文件示例格式

2011-5-18 V2.3

沈文康 1.修改延时分帐、终止分帐接入提交数据

2011-5-13 V2.2.2

沈文康 1. 支付成功返回日期 pay_time 格式修改

2. 对帐、结算文件名格式修改

2011-5-9 V2.2.1

沈文康增加退款通知接口

2011-5-5 V2.1

黄海增加延时分账和终止分账接口

2011-1-25 V2.0

沈文康增加对帐文件下载接口

2011-1-10 V1.9

沈文康修改支付接口分帐类型参数

2010-9-15 V1.8

黄海产品名称统一变更为 ChinaPay 统一支付平台

2010-7-23 V1.7

郭斌 1. 在考试业务配置，支付，退款，查询等接口内容

中添加字符集说明，要求提交数据内容的字符集

为 UTF-8

2. 在考试业务配置，支付，退款，查询，对账，结

算接口中，修改签名规则。首先对待签名字符串

进行 BASE64 编码，然后再对 BASE64 字符串进

行签名。防止出现中文乱码和验签不通过等问

题。

2010-7-14 V1.6

郭斌 1．在考试业务配置，支付，退款，查询等接口中添

加生产地址。

2．在支付接口中，加入商户后台响应信息.如果商户

在接收到后台响应时，不返回 eduok 字样信息。

则默认商户没有收到支付结果后台响应。会在 10

分钟内，每隔一分钟发送一次后台响应，直到商

户返回 eduok 字样信息为止。

2010-6-23 V1.5

郭斌 1．修正文档中多处错别字。

2．修改文档中多出描述不清楚，模糊定义的地方。

3．修改考试业务接口，增加考试业务 ID。可供用户

进行修改考试业务。

4．修改支付分账数据类型，可为费用分账或账户分

账。

第 3 页共 56 页

目  录
ChinaPay 简介...............................................................................................................................6
平台简介.........................................................................................................................................6
前言.................................................................................................................................................6
1. 目的......................................................................................................................................6
总述.................................................................................................................................................7
1. 使用对象..............................................................................................................................7
2. 运行及开发环境..................................................................................................................7
3. 术语......................................................................................................................................7
4. 基本概念..............................................................................................................................8
4.1. 公钥密码体系(Public-key Cryptography)...............................................................9
4.2. 隐秘钥密码体系(Secret-key Cryptography)...........................................................9
4.3. 摘要算法.................................................................................................................10
4.4. 数字签名.................................................................................................................10
4.5. 数字信封.................................................................................................................11
5. 客户端 NetPayClient 在各系统下的安装及调用............................................................12
5.1. 说明.........................................................................................................................12
5.2. NetPayClient for Java 使用说明............................................................................13
5.3. NetPayClient for Win32 使用说明.........................................................................15
5.4. NetPayClient for C 使用说明.................................................................................19
5.5. NetPayClient for C# 使用说明...............................................................................22
5.6. NetPayClient for PHP 使用说明............................................................................26
开户...............................................................................................................................................30
1. 目标....................................................................................................................................30
2. 开户方法............................................................................................................................30
平台配置订单规则及业务信息...................................................................................................31
1. 目标....................................................................................................................................31
2. 配置方法............................................................................................................................32
支付(接口)....................................................................................................................................32
1. 目标....................................................................................................................................32
2. 接入方法............................................................................................................................32
2.1. 接入地址(前台接入)..............................................................................................32
2.2. 接入版本.................................................................................................................32
退款(接口)....................................................................................................................................36
1. 目标....................................................................................................................................36
2. 接入方法............................................................................................................................37
2.1. 接入地址(后台接入)..............................................................................................37
2.2. 接入版本.................................................................................................................37
退款通知接口...............................................................................................................................40
1. 目标....................................................................................................................................40
2. 接入方法............................................................................................................................40

http://www.ChinaPay.com            统一支付平台商户接入手册 
2.1. 接收数据.................................................................................................................40
查询(接口)..................................................................................................................................41
1. 目标..................................................................................................................................41
2. 接入方法..........................................................................................................................41
2.1. 接入地址(后台接入)............................................................................................41
对账(接口)...................................................................................................................................44
1. 目标..................................................................................................................................44
2. 处理流程..........................................................................................................................44
3. 接入方法..........................................................................................................................45
3.1. 接入地址(后台接入)............................................................................................45
3.2. 接入版本...............................................................................................................45
结算(接口)..................................................................................................................................47
1. 目标..................................................................................................................................47
2. 处理流程..........................................................................................................................47
3. 接入方法..........................................................................................................................47
3.1. 接入地址(后台接入)............................................................................................47
3.2. 接入版本...............................................................................................................48
对账文件下载(后台接口)..........................................................................................................50
1. 目标..................................................................................................................................50
2. 接入方法..........................................................................................................................50
2.1. 接入地址(后台接入)............................................................................................51
延时分账(后台接口)..................................................................................................................52
1. 目标..................................................................................................................................52
2. 接入方法..........................................................................................................................52
2.1. 接入地址(后台接入)............................................................................................52
3. 接入版本 20100401.................................................................................................52
终止分账(后台接口)..................................................................................................................55
1. 目标..................................................................................................................................55
2. 接入方法..........................................................................................................................55
2.1. 接入地址(后台接入)............................................................................................55
3. 接入版本 20100401.................................................................................................55
3.1. 请求数据...............................................................................................................55
3.2. 响应数据...............................................................................................................57
附录.............................................................................................................................................58
1. 退款接口错误代码..........................................................................................................58
2. 代扣银行支付列表..........................................................................................................59
3. NetPayClient API 函数错误代码....................................................................................59
第 5 页 共 56 页