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

中国农业银行网上支付平台 B2C PHP商户接口编程指南 Java Edition V1.0 修订历史纪录 日期 版本 说明 作者 2009/06/19 V1.0 初稿 童益柱 目录 1. 简介 4 1.1 目的 4 1.2 功能描述 4 1.3 总体架构图 4 2. 接口开发软件包说明 5 3. 安装步骤 7 3.1 安装前检查 7 3.2 系统配置 7 3.3 Web 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 API 36 MerchantPayment 36 MerchantQueryOrder 40 MerchantVoidPayment 42 MerchantRefund 43 MerchantTrxSettle 44 MerchantTrxSettleByHour 46 IdentityVerify 47 MerchantBatchSend 49 MerchantQueryBatch 50 附录四、TrustPay Client Web Services API 53 附录五、结果处理类 62 com.hitrust.trustpay.client.b2c.PaymentResult 62 简介 目的 提供商户端交易网站通过中国农业银行网上支付平台提供的商户端开发软件包实现功能的编程指南。 功能描述 按照本编程指南所描述的标准，商户交易网站可以呼叫调用，支持功能包括支付请求、取消支付、退货、订单查询、交易对账单下载，并且具备接收网上支付平台支付结果响应的功能。 接口采用电子证书的方式来保证商户与网上支付平台间的身份验证、中间信息传递的完整性，以便进行电子商务安全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。 总体架构图 接口开发软件包说明 银行提供的接口开发软件包 TrustPayClient-B2C-PHP-Vx.x.x.zip（x.x.x为接口开发软件包的版本号）包含下列文档。 文件名称 说明 /docs/农行网上支付平台-B2C商户接口编程指南-PHP-Edition-Vx.x.pdf 本文件 /docs/农行网上支付平台-商户使用手册.pdf 商户使用手册 /docs/农行网上支付平台-USB Key安装及使用手册.pdf USB 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.gz Tomcat应用服务器，包含相关配置 /lib/api.php Php接口 /demo/Merchant.html 接口范例首页 /demo/MerchantPayment.html 支付请求交易范例页面 /demo/MerchantPayment.php 支付请求交易范例程序 /demo/MerchantResult.jsp 支付结果接收范例程序 /de