中国农业银行网上支付平台
商户接口编程指南
Java Edition
V3.1.1
农行网上支付平台
商户接口编程指南 – Java Edition – V3.1.1
网上支付平台开发小组
1
of
116
修订历史记录
日期
版本
说明
作者
2014/9/23
V3.0.0
定稿
网上支付平台开发小组
2015/1/13
V3.0.1
将商品种类分为五大类
网上支付平台开发小组
2015/1/22
V3.0.2
初始化 Dictionary
网上支付平台开发小组
2015/7/16
V3.1.0
支持商户从数据库中读取配置项,网上 K 码支
付—账单发送功能支持账户别名,增加缴费功能
网上支付平台开发小组
2016/7/15
V3.1.1
支持上网代理,支持指定账户支付
网上支付平台开发小组
农行网上支付平台
商户接口编程指南 – Java Edition – V3.1.1
网上支付平台开发小组
2
of
116
目录
1. 简介.............................................................................................................................................. 4
1.1 目的.............................................................................................................................................................. 4
1.2 功能描述...................................................................................................................................................... 4
1.3 总体架构图..................................................................................................................................................4
2. 接口开发软件包说明.................................................................................................................. 5
3. 安装步骤...................................................................................................................................... 9
3.1 安装前检查..................................................................................................................................................9
3.2 接口开发软件包安装..................................................................................................................................9
3.3 接口开发软件包配置..................................................................................................................................9
3.4 配置测试应用..............................................................................................................................................9
4.
配置文件说明
............................................................................................................................ 10
4.1 从配置文件中读取配置项........................................................................................................................10
4.1.1 TrustMerchant.properties
文件
..........................................................................................................10
单个商户配置说明
........................................................................................................................................... 10
多商户配置说明
................................................................................................................................................11
4.1.2 ConfigSource.properties
文件
............................................................................................................12
4.2 从数据库中读取配置项............................................................................................................................12
4.2.1 ConfigSource.properties
文件
............................................................................................................12
5.
客户本地化开发
........................................................................................................................ 13
6. 交易说明.................................................................................................................................... 15
6.1 交易流程.................................................................................................................................................... 15
6.1.1
支付交易
............................................................................................................................................ 15
6.1.2
确保支付结果正确送达商户网站的措施
........................................................................................17
6.1.3
其它交易
............................................................................................................................................ 18
6.2 交易使用时机............................................................................................................................................18
6.3 支付请求.................................................................................................................................................... 20
6.3.1
方式
1
:通过与农行服务器建立连接访问农行支付平台服务
.................................................... 20
6.3.2
方式
2
:通过页面传参提交表单方式访问农行支付平台服务
.................................................... 23
6.4 两种接收支付结果方式的区别................................................................................................................24
6.4.1
通过显示给消费者的支付结果接收页面通知商户
........................................................................24
6.4.2
通过支付平台服务器通知商户
........................................................................................................25
6.4.3
区别
.................................................................................................................................................... 27
6.5 支付结果接收页面....................................................................................................................................28
6.6 单笔退款.................................................................................................................................................... 29
6.7 批量退款.................................................................................................................................................... 30
6.8 批量退款查询............................................................................................................................................32
6.9 交易查询.................................................................................................................................................... 34
6.10 交易流水查询............................................................................................................................................35
6.11 对账单查询................................................................................................................................................36
6.12 网上 K 码支付—账单发送.......................................................................................................................38
6.13 网上 K 码支付—支付请求.......................................................................................................................41
6.14 网上 K 码支付—验证码重发...................................................................................................................43
6.15 授权支付签约(银行端)........................................................................................................................44
6.16 授权支付签约(商户端)—申请............................................................................................................45
农行网上支付平台
商户接口编程指南 – Java Edition – V3.1.1
网上支付平台开发小组
3
of
116
6.17 授权支付签约(商户端)—确认............................................................................................................46
6.18 授权支付签约(商户端)—验证码重发............................................................................................... 47
6.19 授权支付解约............................................................................................................................................48
6.20 授权支付签约/解约结果查询...................................................................................................................49
6.21 单笔授权扣款............................................................................................................................................50
6.22 批量授权扣款............................................................................................................................................52
6.23 批量授权扣款结果查询............................................................................................................................54
6.24 身份验证(页面跳转)............................................................................................................................55
6.25 身份验证结果接收....................................................................................................................................56
6.26 身份验证(非页面跳转)........................................................................................................................57
6.27 预授权确认/取消.......................................................................................................................................58
6.28 实时账单查询............................................................................................................................................59
6.29 缴费结果接收............................................................................................................................................60
附录一、程序范例
........................................................................................................................... 61
附录二、响应码一览表................................................................................................................... 62
附录三、
TRUSTPAY CLIENT API............................................................................................. 64
COM.ABC.PAY.CLIENT.TRXRESPONSE.................................................................................................................... 64
COM.ABC.PAY.CLIENT.TRXREQUEST......................................................................................................................65
COM.ABC.PAY.CLIENT.EBUS.PAYMENTREQUEST................................................................................................... 66
COM.ABC.PAY.CLIENT.EBUS.PAYMENTRESULT......................................................................................................70
COM.ABC.PAY.CLIENT.EBUS.QUERYORDERREQUEST............................................................................................ 72
COM.ABC.PAY.CLIENT.EBUS.REFUNDREQUEST......................................................................................................79
COM.ABC.PAY.CLIENT.EBUS.SETTLEREQUEST....................................................................................................... 81
COM.ABC.PAY.CLIENT.EBUS.AGENTBATCHPAYMENTQUERYREQUEST.................................................................83
COM.ABC.PAY.CLIENT.EBUS.AGENTBATCHPAYMENTREQUEST............................................................................ 85
COM.ABC.PAY.CLIENT.EBUS.AGENTPAYMENTREQUEST........................................................................................88
COM.ABC.PAY.CLIENT.EBUS.AGENTSIGNCONTRACTREQUEST..............................................................................90
COM.ABC.PAY.CLIENT.EBUS.AGENTUNSIGNREQUEST...........................................................................................92
COM.ABC.PAY.CLIENT.EBUS.BATCHREFUNDREQUEST.......................................................................................... 93
COM.ABC.PAY.CLIENT.EBUS.IDENTITYVERIFYREQUEST........................................................................................95
COM.ABC.PAY.CLIENT.EBUS.PREAUTHPAYMENTREQUEST................................................................................... 96
COM.ABC.PAY.CLIENT.EBUS.QUERYAGENTSIGNREQUEST.................................................................................... 98
COM.ABC.PAY.CLIENT.EBUS.QUERYBATCHREQUEST.......................................................................................... 100
COM.ABC.PAY.CLIENT.EBUS.QUERYTRNXRECORDS............................................................................................ 102
COM.ABC.PAY.CLIENT.EBUS.QUICKAGENTSIGNCONFIRM...................................................................................103
COM.ABC.PAY.CLIENT.EBUS.QUICKAGENTSIGNCONTRACTREQUEST................................................................. 105
COM.ABC.PAY.CLIENT.EBUS.QUICKAGENTSIGNRESENDREQ..............................................................................107
COM.ABC.PAY.CLIENT.EBUS.QUICKIDENTITYVERIFYREQUEST...........................................................................108
COM.ABC.PAY.CLIENT.EBUS.QUICKPAYMENTREQUEST...................................................................................... 109
COM.ABC.PAY.CLIENT.EBUS.QUICKPAYMENTRESEND........................................................................................112
COM.ABC.PAY.CLIENT.EBUS.QUICKPAYMENTSEND.............................................................................................113
COM.ABC.PAY.CLIENT.EBUS.PAYMENTMERCHANT..............................................................................................115
COM.ABC.PAY.CLIENT.EBUS.PAYMENTMERCHANTBEAN.................................................................................... 116
农行网上支付平台
商户接口编程指南 – Java Edition – V3.1.1
网上支付平台开发小组
4
of
116
1. 简介
1.1 目的
提供商户端交易网站通过中国农业银行网上支付平台提供的商户端开发软件包实现功能的编
程指南。
1.2 功能描述
按照本编程指南所描述的标准,商户交易网站可以呼叫调用,支持功能包括支付请求、单笔
退款、交易查询、对账单查询等,并且具备接收网上支付平台支付结果响应的功能。
接口采用电子证书的方式来保证商户与网上支付平台间的身份验证、中间信息传递的完整
性,以便进行电子商务安全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。
1.3 总体架构图
- 1
- 2
前往页