农行网上支付平-B2C接口编程指南-PHP_Edition-V1.0

中国农业银行网上支付平台

B2C PHP商户接口编程指南

Java Edition

V1.0

修订历史纪录

日期版本说明作者2009/06/19V1.0初稿童益柱

目录

1.简介4

1.1目的4

1.2功能描述4

1.3总体架构图4

2.接口开发软件包说明5

3.安装步骤7

3.1安装前检查7

3.2系统配置7

3.3Web Services接口应用配置7

3.4配置测试应用8

4.配置文件说明9

5.交易说明10

5.1交易流程10

5.1.1支付交易10

5.1.2确保支付结果正确送达商户网站的措施12

5.1.3其它交易13

5.2交易使用时机14

5.3支付请求15

5.4两种接收支付结果方式的区别17

5.4.1通过显示给消费者的支付结果接收页面通知商户17

5.4.2通过支付平台服务器通知商户18

5.4.3区别20

5.5支付结果接收页面21

5.6取消支付请求22

5.7退货请求23

5.8订单查询24

5.9交易对账单下载25

5.10指定日期指定时间段交易对账单下载25

5.11身份验证交易请求26

5.12身份验证结果接收页面27

5.13退款批量发送请求27

5.14退款批量结果查询请求28

附录一、程序范例30

A、支付请求范例30

B、支付结果接收范例30

C、从服务器直接接收支付结果页面范例31

D、取消支付交易范例32

E、退货交易范例32

F、订单查询交易范例32

G、交易对账单下载范例32

H、指定时间段交易对账单下载32

I、身份验证请求范例32

J、身份验证结果接收范例32

K、退款批量发送请求范例32

L、退款批量结果查询范例33

附录二、响应码一览表34

附录三、TrustPay Client PHP5 API36

MerchantPayment36

MerchantQueryOrder40

MerchantVoidPayment42

MerchantRefund43

MerchantTrxSettle44

MerchantTrxSettleByHour46

IdentityVerify47

MerchantBatchSend49

MerchantQueryBatch50

附录四、TrustPay Client Web Services API53

附录五、结果处理类62

com.hitrust.trustpay.client.b2c.PaymentResult62

简介

目的

提供商户端交易网站通过中国农业银行网上支付平台提供的商户端开发软件包实现功能的编程指南。

功能描述

按照本编程指南所描述的标准，商户交易网站可以呼叫调用，支持功能包括支付请求、取消支付、退货、订单查询、交易对账单下载，并且具备接收网上支付平台支付结果响应的功能。

接口采用电子证书的方式来保证商户与网上支付平台间的身份验证、中间信息传递的完整性，以便进行电子商务安全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。

总体架构图

接口开发软件包说明

银行提供的接口开发软件包 TrustPayClient-B2C-PHP-Vx.x.x.zip(x.x.x为接口开发软件包的版本号)包含下列文档。

文件名称说明/docs/农行网上支付平台-B2C商户接口编程指南-PHP-Edition-Vx.x.pdf本文件/docs/农行网上支付平台-商户使用手册.pdf商户使用手册/docs/农行网上支付平台-USB Key安装及使用手册.pdfUSB Key安装及使用手册/docs/农行网上支付平台-商户端软件包-FAQ.pdf商户开发中常见问题解答/lib/TrustPayClient-Vx.x.x.jar农行网上支付平台商户端接口Java软件包。/lib/WebServices_b2c_php_vx.x.jar农行网上支付平台商户端Web Services接口软件包。/lib/TrustMperties接口配置文件/lib/jakarta-tomcat-5.0.28-b2c-yyyymmdd.tar.gzTomcat应用服务器，包含相关配置/lib/api.phpPhp接口/demo/Merchant.html接口范例首页/demo/MerchantPayment.html支付请求交易范例页面/demo/MerchantPayment.php支付请求交易范例程序/demo/MerchantResult.jsp