中国农业银行网上支付平台
商户接口编程指南
ASP Edition
V2.0.3
农行网上支付平台
商户接口编程指南 – ASP Edition – V2.0.3
网上支付平台开发小组
1 of 100
修订历史纪录
日期
版本
说明
作者
2003-12-29
V0.1
初版
网上支付平台开发小组
2004-01-05
V1.0
支持硬件签名
网上支付平台开发小组
2004-04-01
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
新增对通知商户支付结果的两种方式的说明
网上支付平台开发小组
2004-12-23
V1.6
1、 支持多商户配置
2、 DDL 签名
3、 修正日志文件出现乱码的错误
4、 支持商户指定配置文件的档名及存放目录
网上支付平台开发小组
2005-03-01
V1.7
1、 修正 WSE 1.0 错误
2、 支持 WSE 2.0
3、 增加日志开关
网上支付平台开发小组
2005-05-10
V2.0
1、 修正无法写入日志的问题
2、 优化程序执行效能
3、 支持压缩下载对账单
4、 支持保存对账单至文件、由文件读取对账单
5、 修正接收支付平台直接通知页面范例
网上支付平台开发小组
2009-05-31
V2.1
1、 修正多商户模式的参数问题
2、 修正两种通知模式的页面歧义
3、 提供.NET2.0 环境下的接口包
4、 加入常见问题的解决办法
网上支付平台开发小组
2010-8-23
V2.0.2
为防钓鱼支付在订单信息中添加客户 IP 地址
BuyIP,支持手机 WAP 支付和电话支付请求
网上支付平台开发小组
2011-01-14
V2.0.3
1、增加交易
网上支付平台开发小组
农行网上支付平台
商户接口编程指南 – ASP Edition – V2.0.3
网上支付平台开发小组
2 of 100
目录
1. 简介 .............................................................................................................................................. 5
1.1 目的 ............................................................................................................................................................ 5
1.2 功能描述 .................................................................................................................................................... 5
1.3 总体架构图 ................................................................................................................................................ 5
2. 接口开发软件包说明 .................................................................................................................. 6
3. 安装步骤 ...................................................................................................................................... 8
3.1 安装前检查 ................................................................................................................................................ 8
3.2 接口开发软件包安装 ................................................................................................................................ 8
3.3 接口开发软件包配置 ................................................................................................................................ 8
3.4 配置测试应用 ............................................................................................................................................ 9
3.5 移除接口开发软件包 ................................................................................................................................ 9
4. 配置文件说明 ............................................................................................................................ 10
4.1 单一商户配置说明 .................................................................................................................................. 10
4.2 多商户配置说明 ...................................................................................................................................... 11
5. 交易说明 .................................................................................................................................... 12
5.1 交易流程 .................................................................................................................................................. 12
5.1.1
支付交易
.......................................................................................................................................... 12
5.1.2
确保支付结果正确送达商户网站的措施
...................................................................................... 14
5.1.3
其它交易
.......................................................................................................................................... 15
5.2 交易使用时机 .......................................................................................................................................... 16
5.3 支付请求 .................................................................................................................................................. 17
5.3.1
方式
1
:通过与农行服务器建立连接访问农行
b2c
支付平台服务
............................................ 17
5.3.2
方式
2
:通过页面传参提交表单方式访问农行
b2c
支付平台服务
............................................ 19
5.4 两种接收支付结果方式的区别 .............................................................................................................. 20
5.4.1
通过显示给消费者的支付结果接收页面通知商户
...................................................................... 20
5.4.2
通过支付平台服务器通知商户
...................................................................................................... 21
5.4.3
区别
.................................................................................................................................................. 23
5.5 支付结果接收页面 .................................................................................................................................. 24
5.6 退货请求 .................................................................................................................................................. 25
5.7 订单查询 .................................................................................................................................................. 26
5.8 交易对账单下载 ...................................................................................................................................... 27
5.9 指定日期指定时间段交易对账单下载 .................................................................................................. 27
5.10 身份验证交易请求 .................................................................................................................................. 28
5.11 身份验证结果接收页面 .......................................................................................................................... 29
5.12 退款批量发送请求 .................................................................................................................................. 29
5.13 退款批量结果查询请求 .......................................................................................................................... 30
5.14 委托扣款签约请求 .................................................................................................................................. 31
5.15 委托扣款解约请求 .................................................................................................................................. 32
5.16 委托扣款单笔代扣请求 .......................................................................................................................... 33
5.17 委托扣款批量请求 .................................................................................................................................. 34
5.18 委托扣款批量结果查询 .......................................................................................................................... 35
5.19 贷记卡交易对账单下载 .......................................................................................................................... 36
5.20 网上付款信息发送请求 .......................................................................................................................... 37
农行网上支付平台
商户接口编程指南 – ASP Edition – V2.0.3
网上支付平台开发小组
3 of 100
5.21 网上付款交易结果查询请求 .................................................................................................................. 38
5.22 网上付款银行卡状态验证请求 .............................................................................................................. 39
附录一、程序范例 ........................................................................................................................... 41
A、支付请求范例 .............................................................................................................................................. 41
B、查询订单范例 .............................................................................................................................................. 43
C、退货交易范例 .............................................................................................................................................. 44
D、支付结果接收 .............................................................................................................................................. 44
E、身份验证请求范例 ....................................................................................................................................... 45
F、身份验证结果接收 ....................................................................................................................................... 46
G、下载交易对账单范例 .................................................................................................................................. 46
H、结算对账单下载 .......................................................................................................................................... 47
I、商户订单查询 ................................................................................................................................................ 48
J、查询批量退款处理结果 ................................................................................................................................ 49
K、下载指定时间段交易对账单范例 .............................................................................................................. 50
L、身份验证请求范例 ....................................................................................................................................... 52
M、批量退款发送请求范例 .............................................................................................................................. 52
N、批量退款查询请求范例 .............................................................................................................................. 53
O、委托扣款解约请求范例 .............................................................................................................................. 54
P、委托扣款批量交易请求范例 ....................................................................................................................... 55
Q、委托扣款单笔代扣请求交易范例 .............................................................................................................. 57
R、委托扣款签约请求交易范例 ....................................................................................................................... 57
S、委托扣款批量处理结果查询请求交易范例 ............................................................................................... 58
T、下载贷记卡交易对账单 ............................................................................................................................... 59
U、网上付款信息发送请求范例 ...................................................................................................................... 60
V、网上付款交易结果查询请求范例 .............................................................................................................. 62
W、网上付款银行卡状态验证请求范例.......................................................................................................... 64
附录二、响应码一览表 ................................................................................................................... 66
附录三、TRUSTPAY CLIENT API ............................................................................................. 68
COM.HITRUST.TRUSTPAY.CLIENT.TRXRESPONSE ................................................................................................ 68
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ORDER ..................................................................................................... 69
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ORDERITEM ............................................................................................. 71
COM.HITRUST.TRUSTPAY.CLIENT.B2C.PAYMENTREQUEST .................................................................................. 72
COM.HITRUST.TRUSTPAY.CLIENT.B2C.PAYMENTRESULT .................................................................................... 74
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYORDERREQUEST ........................................................................... 75
COM.HITRUST.TRUSTPAY.CLIENT.B2C.REFUNDREQUEST .................................................................................... 76
COM.HITRUST.TRUSTPAY.CLIENT.B2C.SETTLEREQUEST ...................................................................................... 77
COM.HITRUST.TRUSTPAY.CLIENT.B2C.SETTLEFILE ............................................................................................. 78
COM.HITRUST.TRUSTPAY.CLIENT.B2C.IDENTITYVERIFYREQUEST ...................................................................... 78
COM.HITRUST.TRUSTPAY.CLIENT.B2C.BATCH ..................................................................................................... 80
COM.HITRUST.TRUSTPAY.CLIENT.B2C.OVERDUEBATCH ..................................................................................... 81
COM.HITRUST.TRUSTPAY.CLIENT.B2C.BATCHSENDREQUEST ............................................................................. 82
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYBATCHREQUEST ........................................................................... 82
COM.HITRUST.TRUSTPAY.CLIENT.B2C.OVERDUEREFUNDREQUEST .................................................................... 83
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTSIGNRESULT ......................................................................... 84
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTSIGNCONTRACTREQUEST ..................................................... 84
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTUNSIGNCONTRACTREQUEST ................................................ 86
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTPAYMENTREQUEST ............................................................... 87
COM.HITRUST.TRUSTPAY.CLIENT.B2C.AGENTBATCH .......................................................................................... 88
COM.HITRUST.TRUSTPAY.CLIENT.B2C.AGENTBATCHDETAIL .............................................................................. 90
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTBATCHREQUEST.................................................................... 91
COM.HITRUST.TRUSTPAY.CLIENT.B2C.B2CAGENTBATCHQUERYREQUEST ........................................................ 91
农行网上支付平台
商户接口编程指南 – ASP Edition – V2.0.3
网上支付平台开发小组
4 of 100
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ONLINEREMITREQUEST ........................................................................... 92
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ONLINERMTCARDVERIFYREQUEST ........................................................ 93
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ONLINERMTQUERYRESULTREQUEST ..................................................... 94
COM.HITRUST.TRUSTPAY.CLIENT.B2C.ONLINERMTBATCH ................................................................................. 94
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYRESULT ........................................................................................ 95
COM.HITRUST.TRUSTPAY.CLIENT.B2C.QUERYRESULTITEM ................................................................................ 96
附录四、常见问题及解决办法 ....................................................................................................... 98
1. SERVER OBJECT ERROR ............................................................................................................................. 98
2. 找不到 TRUSTPAYCONNECTMETHOD 参数 ............................................................................................ 98
3. 无法连接 .................................................................................................................................................. 98
4. WSE2.0 安装不上 ................................................................................................................................... 99
5. 无法读取证书文档 .................................................................................................................................. 99
6. 返回报文签名验证失败 .......................................................................................................................... 99
7. 类型初始值设定引发异常 ...................................................................................................................... 99
8. 服务器换 IP 后的通知问题 .................................................................................................................. 100
9. 商户端配置文件中参数设置错误 ........................................................................................................ 100
10. 无法写入日志 ........................................................................................................................................ 100