中国农业银行网上支付平台
商户接口编程指南
Java Edition
V2.0.8
农行网上支付平台
商户接口编程指南 – Java Edition – V2.0.8
网上支付平台开发小组
1 of 139
修订历史纪录
日期
版本
说明
作者
2003/11/26
V0.1
草案
网上支付平台开发小组
2003/12/10
V0.2
修改
网上支付平台开发小组
2003-12-18
V0.3
修改
网上支付平台开发小组
2004-01-05
V1.0
支持硬件签名
网上支付平台开发小组
2004-03-29
V1.0.1
加强商户接收交易结果的说明
网上支付平台开发小组
2004-04-04
V1.0.2
更改接口开发软件包文件名
网上支付平台开发小组
2004-04-16
V1.0.3
新增商户指定支付类型，用以支持国际卡支付
网上支付平台开发小组
2004-05-31
V1.0.4
新增对于 zip 包里新加文件的说明
网上支付平台开发小组
2004-06-16
V1.1
新增对商户开发支付请求和接收页面时的提示
网上支付平台开发小组
2004-08-12
V1.1.1
新增对商户设定支付类型时的注意事项
网上支付平台开发小组
2004-09-27
V1.5
新增对通知商户支付结果的两种方式的说明
网上支付平台开发小组
2005-05-11
V2.0
1、 修正无法写入日志的问题
2、 优化程序执行效能
3、 支持压缩下载对帐单
4、 支持保存对帐单至文件、由文件读取对帐单
5、 修正接收支付平台直接通知页面范例
网上支付平台开发小组
2005-01-06
V2.0.1
1、 添加基金网上支付
2、 添加指定日期指定时间交易对账单下载
网上支付平台开发小组
2008-02-14
V2.0.2
新增客户身份验证交易
网上支付平台开发小组
2008-06-20
V2.0.3
新增批量退款功能
网上支付平台开发小组
2009-05-31
V2.0.4
1、 新增批量退款功能
2、 新增委托扣款功能
3、 新增贷记卡支付功能
网上支付平台开发小组
2009-07-01
V2.0.5
1、 新增商户通过页面提交访问农行 b2c 服务
的功能
网上支付平台开发小组
农行网上支付平台
商户接口编程指南 – Java Edition – V2.0.8
网上支付平台开发小组
2 of 139
2010-03-01
V2.0.6
1. 农行借记卡和贷记卡支付方式合并
网上支付平台开发小组
2010-08-01
V2.0.7
防钓鱼支付修改，接口发送请求中增加买方 IP
地址字段 BuyIP
网上支付平台开发小组
2010-11-25
V2.0.8
加入保险支付的交易，删除基金相关交易，增加
对退款订单号的支持
网上支付平台开发小组
农行网上支付平台
商户接口编程指南 – Java Edition – V2.0.8
网上支付平台开发小组
3 of 139
目录
1. 简介 .............................................................................................................................................. 6
1.1 目的 ............................................................................................................................................................ 6
1.2 功能描述 .................................................................................................................................................... 6
1.3 总体架构图 ................................................................................................................................................ 6
2. 接口开发软件包说明 .................................................................................................................. 7
3. 安装步骤 .................................................................................................................................... 10
3.1 安装前检查 .............................................................................................................................................. 10
3.2 接口开发软件包安装 .............................................................................................................................. 10
3.3 接口开发软件包配置 .............................................................................................................................. 10
3.4 配置测试应用 .......................................................................................................................................... 10
4. 配置文件说明 ............................................................................................................................ 11
5. 交易说明 .................................................................................................................................... 13
5.1 交易流程 .................................................................................................................................................. 13
5.1.1
支付交易
.......................................................................................................................................... 13
5.1.2
确保支付结果正确送达商户网站的措施
...................................................................................... 15
5.1.3
其它交易
.......................................................................................................................................... 16
5.2 交易使用时机 .......................................................................................................................................... 17
5.3 支付请求 .................................................................................................................................................. 18
5.3.1
方式
1
：通过与农行服务器建立连接访问农行
b2c
支付平台服务
............................................ 18
5.3.2
方式
2
：通过页面传参提交表单方式访问农行
b2c
支付平台服务
............................................ 20
5.4 两种接收支付结果方式的区别 .............................................................................................................. 22
5.4.1
通过显示给消费者的支付结果接收页面通知商户
...................................................................... 22
5.4.2
通过支付平台服务器通知商户
...................................................................................................... 23
5.4.3
区别
.................................................................................................................................................. 25
5.5 支付结果接收页面 .................................................................................................................................. 26
5.6 退货请求 .................................................................................................................................................. 26
5.7 订单查询 .................................................................................................................................................. 28
5.8 交易对账单下载 ...................................................................................................................................... 30
5.9 指定日期指定时间段交易对账单下载 .................................................................................................. 31
5.10 农行卡身份验证交易请求 ...................................................................................................................... 32
5.11 卡验证结果接收页面 .............................................................................................................................. 32
5.12 身份验证交易请求 .................................................................................................................................. 33
5.13 身份验证结果接收页面 .......................................................................................................................... 33
5.14 批量退款发送请求 .................................................................................................................................. 34
5.15 批量退款结果查询请求 .......................................................................................................................... 35
5.16 委托扣款签约请求 .................................................................................................................................. 36
5.17 委托扣款解约请求 .................................................................................................................................. 37
5.18 委托扣款单笔代扣请求 .......................................................................................................................... 38
5.19 委托扣款批量请求 .................................................................................................................................. 39
5.20 委托扣款批量结果查询 .......................................................................................................................... 40
5.21 贷记卡交易对账单下载 .......................................................................................................................... 41
5.22 保险直销支付请求 .................................................................................................................................. 42
5.22.1
方式
1
：通过与农行服务器建立连接访问农行
b2c
支付平台服务
............................................ 42
5.22.2
方式
2
：通过页面传参提交表单方式访问农行
b2c
支付平台服务
............................................ 45
5.23 付款信息发送请求 .................................................................................................................................. 45
农行网上支付平台
商户接口编程指南 – Java Edition – V2.0.8
网上支付平台开发小组
4 of 139
5.24 付款交易结果查询请求 .......................................................................................................................... 46
5.25 付款银行卡状态查询请求 ...................................................................................................................... 48
附录一、程序范例 ........................................................................................................................... 50
A、支付请求范例 .............................................................................................................................................. 50
B、支付结果接收范例 ...................................................................................................................................... 52
C、从服务器直接接收支付结果页面范例 ....................................................................................................... 54
D、退货交易范例 .............................................................................................................................................. 55
E、订单查询交易范例 ....................................................................................................................................... 57
F、交易对账单下载范例 ................................................................................................................................... 59
G、指定时间段交易对账单下载 ...................................................................................................................... 61
H、卡验证请求范例 .......................................................................................................................................... 62
I、卡身份验证结果接收范例 ............................................................................................................................ 63
J、身份验证请求范例 ........................................................................................................................................ 64
K、身份验证结果接收范例 .............................................................................................................................. 65
L、批量退款发送请求范例 ............................................................................................................................... 66
M、批量退款交易结果查询请求范例 .............................................................................................................. 69
N、委托扣款签约交易请求范例 ...................................................................................................................... 70
O、委托扣款解约交易请求范例 ...................................................................................................................... 71
P、委托扣款单笔代扣交易请求范例 ............................................................................................................... 73
Q、委托扣款批量交易请求范例 ...................................................................................................................... 74
R、委托扣款批量结果查询交易请求范例 ....................................................................................................... 77
S、贷记卡对账单下载交易请求范例 ............................................................................................................... 79
T、商户通过页面传参数提交表单方式访问农行 B2C 服务范例程序 ........................................................... 81
U、商户本地返回错误页面范例 ...................................................................................................................... 83
V、支付平台返回错误页面范例 ...................................................................................................................... 84
W、保险直销支付请求范例 ............................................................................................................................. 84
Y、商户通过页面传参数提交表单方式进行保险支付请求范例 ................................................................... 87
Z、网上付款信息发送请求范例 ....................................................................................................................... 90
AA、网上付款交易结果查询请求范例............................................................................................................ 92
AB、网上付款银行卡状态验证请求范例 ........................................................................................................ 94
附录二、响应码一览表 ................................................................................................................... 95
附录三、TRUSTPAY CLIENT API ............................................................................................. 98
COM.HITRUST.TRUSTPAY.CLIENT.TRXRESPONSE ................................................................................................ 98
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ORDER ..................................................................................................... 99
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ORDERITEM ........................................................................................... 101
COM.HITRUST.TRUSTPAY.CLIENT.B2C.PAYMENTREQUEST ................................................................................ 103
COM.HITRUST.TRUSTPAY.CLIENT.B2C.PAYMENTRESULT .................................................................................. 105
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYORDERREQUEST ......................................................................... 107
COM.HITRUST.TRUSTPAY.CLIENT.B2C.VOIDPAYMENTREQUEST ....................................................................... 108
COM.HITRUST.TRUSTPAY.CLIENT.B2C.REFUNDREQUEST .................................................................................. 109
COM.HITRUST.TRUSTPAY.CLIENT.B2C.SETTLEREQUEST .................................................................................... 111
COM.HITRUST.TRUSTPAY.CLIENT.B2C.SETTLEFILE ........................................................................................... 112
COM.HITRUST.TRUSTPAY.CLIENT.B2C.IDENTITYVERIFYREQUEST .................................................................... 113
COM.HITRUST.TRUSTPAY.CLIENT.B2C.BATCH ................................................................................................... 115
COM.HITRUST.TRUSTPAY.CLIENT.B2C.OVERDUEBATCH ................................................................................... 116
COM.HITRUST.TRUSTPAY.CLIENT.B2C.BATCHSENDREQUEST ........................................................................... 118
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYBATCHREQUEST ......................................................................... 119
COM.HITRUST.TRUSTPAY.CLIENT.B2C.OVERDUEREFUNDREQUEST .................................................................. 119
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYOVERDUEREFUNDREQUEST ....................................................... 120
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTSIGNRESULT ....................................................................... 122
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTSIGNCONTRACTREQUEST ................................................... 122
- 1
- 2
- 3
- 4
前往页