农行支付环境接口配置
中国农业银行接口出入金相关操作手册
中国农业银行接口出入金相关操作手册--------------------------------------------------------------------------作者: _____________--------------------------------------------------------------------------日期: _____________中国农业银行接口出入金相关操作手册一、签约1、登录客户端，插入农行K宝，点击“申请出入金”。
2、由于未签约，页面自动跳转到签约界面，选择“签约接口”，这里选择“中国农行接口”；输入“交易密码”（默认为注册会员时的证件号末六位）。
3、点击“签约”按钮，跳出确认框后点击“确定”。
4、跳出“选择用于签名的本人证书”框，点击下拉框选择证书，后点击“确定”。
5、输入K宝密码，点击确定，显示“签约成功”，后点击“农行签约需要制定账号—农行电子商务登录”字样。
6、跳出中国农业银行网页后，点击“电子商务登录”。
7、跳出新页面后，点击“证书客户登录”。
8、跳出新页面后，点击交易市场管理—管理—客户服务协议签约，跳出“帮助信息后”，点击“下一步”。
9、跳出“已经签约的商户”后，填充圆圈选择签约商户后，点击“确定”。
10、跳出“客户具有的账户列表”，填充圆圈选择账户后，点击“点击此处下载控件”，如图完成以下控件安装流程。
11、控件安装完成后，点击“此处”刷新。
12、刷新成功后重新跳转到登录“交易市场管理”页面，重新选择“交易市场管理”—“管理”—“客户服务协议签约”，之后跟先前的操作步骤一致。
13、页面跳转到“客户具有的账户列表”，填充圆圈，输入“支付密码”（银行卡密码），点击“确定”。
14、签约成功。
二、入金1、返回客户端，点击“申请出入金”。
2、点击“入金申请”。
3、输入入金金额与交易密码（默认为注册会员时的证件号末六位）,点击“入金”后跳出确认框，点击“确定”。
支付接口对接教程
支付接口对接教程支付接口对接教程（1000字）一、概述支付接口是指商户与支付机构之间的协议和接口，用于实现在线支付功能。
对接支付接口是进行网上支付的基础操作，所以对接支付接口是开发和运营电商平台的必备技能之一。
本文将详细介绍支付接口对接的过程和注意事项，供开发人员参考。
二、了解支付接口在进行支付接口对接之前，首先需要了解支付接口的基本原理和常见的支付方式。
常见的支付方式有支付宝、微信支付、银联支付等。
了解支付方式可以帮助我们选择合适的支付接口，并了解接口的使用方法和限制。
三、选择支付接口根据自己的需求，选择适合的支付接口。
首先需要考虑接口的稳定性和可靠性，其次需要了解接口的价格和费用。
一般情况下，支付接口分为第三方支付接口和银行直连接口两种。
第三方支付接口可以快速接入，无需太多的技术开发；银行直连接口需要更多的技术开发和审核，但是更加稳定和安全。
四、申请支付接口选择好支付接口后，需要联系支付机构进行申请。
不同的支付机构对接口申请的要求可能有所不同，一般需要提供企业资质、技术开发文档和费用信息等。
填写申请表格并按照支付机构的要求提供相关材料，然后等待支付机构的审批。
五、开发支付功能在申请支付接口的同时，需要进行相关的技术开发工作。
根据支付机构提供的开发文档，按照文档中的接口规范和参数要求，完成开发工作。
开发过程中需要注意安全性和易用性。
六、测试支付功能在开发完成后，需要进行支付功能的测试。
验证支付功能的正确性和稳定性，包括支付请求和回调通知的处理等。
可以使用支付机构提供的测试工具进行测试，或者与支付机构联系协助测试。
七、上线支付功能完成支付功能的开发和测试之后，可以将支付功能上线。
需要将支付功能部署到线上服务器，并确保服务器的稳定性和安全性。
同时需要向支付机构提供相关的配置信息，将支付功能与支付机构的系统进行对接。
八、支付接口的后续维护上线之后，需要进行支付接口的后续维护工作。
及时关注支付机构的接口更新和变更通知，确保支付功能的正常运行。
农行支付接口开发--支付流程整理
农行支付接口开发--支付流程整理这里说的农行包含农行的第三方支付，因为他的流程和处理方式完全一致一、订单状态待支付：用户提交订单的时候赋予此状态（可再支付）支付成功，待确认：在农行的通知页面里，success代码中赋予此状态（不可再支付）支付失败：在农行的通知页面里，fail代码中赋予此状态（可再支付）交易成功：在支付宝的通知页面里，success代码中赋予此状态；在农行的查询订单代码中，当农行返回03、04时赋予此状态（不可再支付）交易失败：在支付宝的通知页面里，fail代码中赋予此状态；在农行的查询订单代码中，当农行返回00时，赋予此状态（可再支付）二、支付流程首先、支付宝和农行都有一个异步通知页面。
这个页面很关键这2个页面都有一个判断支付是否成功的代码对于支付宝来说，支付成功，就意味着交易成功，可以马上将用户的订单状态改为“交易成功”对于农行来说，支付成功，只能表示用户的钱已经扣了，但是农行还没有到账，此时订单状态改为“已支付、待确认”，这种状态下，用户不能再次支付，否则要造成重复支付。
在这个通知页面里的代码没有执行前，我们都可以肯定用户是没有支付的，这种情况下，用户可以再次支付。
当这个通知页面执行后，就要分两种情况。
支付宝通知页面里的success就意味着交易完成，可以将订单状态改为“交易完成”，否则就是“交易失败”农行通知页面里的success表示用户已经支付了，扣款了。
但是钱不一定到农行的账户。
这个时候订单状态改为“支付成功、待确认”这种状态下，用户不能再次对这个订单进行支付通知页面的fail表示支付失败，这种状态下，可以再次进行支付。
针对农行，需要设计一个定时器，定时查询处于“支付成功、待确认”02状态下的订单。
根据查询订单的返回值，改变订单的状态。
农行批量代付接口
农行批量代付接口1.批量代付流程①一卡通生成批量代付文件，上传到指定的ftp目录下②农行由指定ftp目录获取批量代付文件③农行执行批量代付业务④农行生成批量代付结果文件，上传到指定的ftp目录下⑤一卡通由指定ftp目录获取农行代付结果文件，解析入库2.文件说明1.1.文件命名一卡通生成批量代付文件命名为Abcbank_yyyymmdd_index_request.txt农行返回文件名为一卡通生成批量代付文件命名为Abcbank_yyyymmdd_index_response.txt其中yyyymmdd 为4位年2位月2位日期，index表示为自增序列号长度为3 由001开始。
1.2.文件大小每个代付文件大小定义为最多5000条。
每条数据长度为173每个文件大小约为865K1.3.文件编码由于文件中存在汉字，整体使用gbk编码。
1.4.文件格式1.4.1.请求文件1.4.1.1. 文件头编号字段名称长度必输项备注1 批交易总笔数 6 必输右对齐，左补02 批交易总金额15 必输右对齐，左补0，精确到分，小数点后保留2位1.4.1.2. 文件体编号字段名称长度必输项备注1 客户帐号19 必输2 客户名称10 选输如果校验户名时为必输3 代理种类4 选输4 代理单位客户编号20 选输5 处理顺序号8 选输6 交易日期8 选输交易日期，解包时舍弃7 证件类型 6 选输如果校验证件时必输8 证件号码30 选输如果校验证件时必输9 交易金额12 必输金额的单位是什么？如何格式化10 实际发生额12 选输11 银行返回码 4 选输12 备注1 40 选输1.4.1.3. 样例[622848*************张三00000001 20101215110001120101195510010045 000000001.00 ] 1.4.2.返回文件1.4.2.1. 7.3.1文件头无1.4.2.2. 文件体编号字段名称长度备注1 客户帐号192 客户名称103 代理种类 44 代理单位客户编号205 处理顺序号86 交易日期87 证件类型 68 证件号码309 交易金额1210 实际发生额1211 银行返回码 412 备注1 40 Citycard: bankcard:1.4.2.3. 样例[622848*************张三00000001 20101215110001120101195510010045 000000001.00 0000 ]。
农行支付接口的数据格式
农行支付接口的数据格式是这样的<MSG><Message><Merchant><ECMerchantType>B2C</ECMerchantType><MerchantID>233010300330A01</MerchantID></Merchant><TrxRequest><TrxType>PayReq</TrxType><Order><OrderNo>ON200306300001</ OrderNo><OrderAmount>280.0</OrderAmount><OrderDesc>Game Card Order</ OrderDesc><OrderDate>2003/11/12</OrderDate><OrderTime>23:55:30</OrderTime><OrderURL>http://127.0.0.1/Merchant/MerchantQueryOrder.jsp?ON=ON200306300001&QueryType=1</OrderURL><OrderItems><OrderItem><ProductID>IP000001</ProductID><ProductName>中国移动IP卡</ProductName><UnitPrice>100.0</UnitPrice><Qty>1</Qty></OrderItem><OrderItem><ProductID>IP000002</ProductID><ProductName>网通IP卡</ProductName><UnitPrice>90.0</UnitPrice><Qty>2</Qty></OrderItem></OrderItems></Order><ProductType>1</ProductType><PaymentType>1</PaymentType><NotifyType>0</NotifyType><ResultNotifyURL>http://127.0.0.1/Merchant/MerchantResult.jsp</ResultNotifyURL><MerchantRemarks>Hi!</ MerchantRemarks><PaymentLinkType>1</PaymentLinkType></TrxRequest></Message><Signature-Algorithm>SHA1withRSA</Signature-Algorithm><Signature>nfJAveUtLG1YHqsjUdopB8Jl9QX4ZtlQrUn+HoiCy0yS9An19z5IxTIVYO uQXjNnbMGgmZlCwK3dSSnRTLHxZMC3zJUiE58qEwxatOgHNFUhAHTBxkUMO5ikC7C5qm/ 9L67/Xp7kYvHK9Fo/8CyXckROb+w+eLYcPaYo6+Of2Dg=</Signature></MSG>数据有以下几部分构成<MSG><Message>订单信息</Message><Signature-Algorithm>SHA1withRSA</Signature-Algorithm><Signature>订单信息的签名</Signature></MSG>订单信息的构造参考：<Merchant><ECMerchantType>B2C</ECMerchantType><MerchantID>233010300330A01</ MerchantID></Merchant><TrxRequest><TrxType>PayReq</TrxType><Order><OrderNo>ON200306300001</OrderNo><OrderAmount>280.0</ OrderAmount><OrderDesc>Game Card Order</OrderDesc><OrderDate>2003/11/12</OrderDate><OrderTime>23:55:30</OrderTime><OrderURL>http://127.0.0.1/Merchant/MerchantQueryOrder.jsp?ON=ON200306300001&QueryType=1</OrderURL><OrderItems><OrderItem><ProductID>IP000001</ProductID><ProductName>中国移动IP卡</ProductName><UnitPrice>100.0</UnitPrice><Qty>1</Qty></OrderItem><OrderItem><ProductID>IP000002</ProductID><ProductName>网通IP卡</ ProductName><UnitPrice>90.0</UnitPrice><Qty>2</Qty></OrderItem></OrderItems></ Order><ProductType>1</ProductType><PaymentType>1</PaymentType><NotifyType>0</ NotifyType><ResultNotifyURL>http://127.0.0.1/Merchant/MerchantResult.jsp</ ResultNotifyURL><MerchantRemarks>Hi!</MerchantRemarks><PaymentLinkType>1</PaymentLinkType></TrxRequest>整体上由Merchant商户信息段和TrxRequest请求信息段，两部分构成。
网络支付接口规范
网络支付接口规范在当今数字化的时代，网络支付已经成为我们日常生活中不可或缺的一部分。
无论是购物、缴费还是转账，网络支付为我们提供了便捷、高效的服务。
然而，为了保障支付的安全、稳定和可靠，网络支付接口需要遵循一系列严格的规范。
网络支付接口，简单来说，就是连接支付系统和各种应用程序的桥梁。
它允许用户通过不同的平台和设备进行支付操作，实现资金的流转。
但如果这个接口缺乏规范，就可能会引发一系列问题。
首先，安全性是网络支付接口规范中最为关键的一点。
支付接口必须采用高强度的加密技术，对用户的支付信息，如银行卡号、密码、身份证号等进行加密处理，确保这些敏感信息在传输和存储过程中不被窃取或篡改。
同时，要建立完善的身份验证机制，防止非法用户通过伪造身份进行支付操作。
比如，除了常见的用户名和密码验证，还可以结合短信验证码、指纹识别、面部识别等多种验证方式，提高身份验证的准确性和安全性。
其次，稳定性也是不容忽视的一个方面。
网络支付接口要能够应对高并发的支付请求，确保在大量用户同时进行支付时，系统不会出现卡顿、崩溃或数据丢失等问题。
这就需要对接口进行充分的性能测试和优化，合理分配系统资源，保障支付流程的顺畅进行。
再者，兼容性也是网络支付接口规范的重要考量因素。
由于市场上存在着各种各样的操作系统、浏览器和移动设备，支付接口需要能够兼容不同的平台和环境，为用户提供一致的支付体验。
无论是在Windows 系统、iOS 系统还是 Android 系统上，无论是使用 Chrome 浏览器、Safari 浏览器还是其他浏览器，用户都应该能够顺利完成支付操作。
在接口的设计和实现上，也有一系列的规范需要遵循。
接口的参数设置应该清晰明了，易于理解和使用。
错误处理机制要完善，当支付过程中出现异常情况时，能够及时向用户返回准确的错误信息，并提供相应的解决建议。
同时，接口的文档要详细、准确，为开发者提供全面的技术支持，方便他们进行对接和开发。
支付系统商服权限配置
无
（开通分账功能商户）且（开通业务流程审核 的功能的商户）
无
（开通分账功能商户）且（开通业务流程审核 的功能的商户）
无
有
有
有
无
有
分账管理 链接支付 安全管理
余额变动查询 资金台账查询 划付记录查询 集团商户分润报表
子商户分账规则 分账结果查询 分账规则审核 分账规则设置 结算申请 账户管理 分账方式申请审核 结算金额分账交易查询 单笔分账交易查询
无
无
无
有
无
无
无
无
有
有
无
有
有
无
有
有
无
有
有无ຫໍສະໝຸດ 链接查询 链接管理 当日交易查询 历史交易查询 邮箱配置 邮件日志查询 上传LOGO
商户密钥设置 商户公钥设置 平台公钥下载
有
有
有
集团商户
有
开通分账功能商户
有
（开通分账功能商户）且（集团商户）
有
开通分账功能商户
有
开通分账功能商户
无
不为集团商户
有
（不为集团商户）且（结算周期为自主结算） 有
开通分账功能商户
有
开通代付支付方式的商户
无
开通代付支付方式的商户
有
开通代付支付方式的商户
有
（开通代付支付方式的商户）且（不为集团商 户）且（开通业务流程审核的功能的商户）
无
有
有
有
不为集团商户
有
有
开通了业务流程审核的功能的商户
无
开通了业务流程审核的功能的商户
无
开通了业务流程审核的功能的商户
无
开通了业务流程审核的功能的商户
支付 适配接口参数
支付适配接口参数支付适配接口参数是指在支付系统中，为了实现不同支付渠道的兼容性，需要进行参数适配的过程。
本文将从支付适配接口参数的概念、作用和常见参数进行详细介绍，以便读者对该主题有更深入的了解。
一、支付适配接口参数的概念支付适配接口参数是指在进行支付交易时，为了适应不同支付渠道的要求而需要传递的参数。
不同的支付渠道对于支付接口的参数要求可能存在差异，因此需要通过适配接口参数来实现不同渠道之间的兼容性。
二、支付适配接口参数的作用支付适配接口参数的作用主要有以下几个方面：1. 实现支付渠道的兼容性：不同的支付渠道对于支付接口的参数要求可能存在差异，通过适配接口参数可以实现不同渠道之间的兼容性，使得商户可以同时接入多个支付渠道，提高支付的灵活性和便利性。
2. 保障支付交易的安全性：支付适配接口参数可以包含一些安全相关的信息，如签名、密钥等，通过对这些参数的正确传递和验证，可以确保支付交易的安全性，防止支付信息被篡改或泄露。
3. 实现支付交易的功能扩展：支付适配接口参数可以包含一些扩展功能相关的信息，如分账标识、优惠券信息等，通过正确传递这些参数，可以实现支付交易的功能扩展，满足商户和用户的特殊需求。
三、常见的支付适配接口参数1. 商户号（merchantId）：用于标识商户的唯一身份，不同支付渠道可能有不同的商户号。
2. 订单号（orderId）：用于标识支付交易的唯一订单号，商户和支付渠道需要保持一致。
3. 支付金额（amount）：支付交易的金额，通常以人民币（CNY）为单位。
4. 支付方式（paymentMethod）：指定支付使用的方式，如支付宝、微信支付等。
5. 支付结果通知地址（notifyUrl）：支付结果异步通知的地址，支付渠道会将支付结果发送到该地址，供商户进行处理。
6. 支付成功跳转地址（returnUrl）：支付成功后的同步跳转地址，用户支付成功后将跳转到该地址。
7. 签名（sign）：用于确保支付请求的真实性和完整性，采用加密算法对请求参数进行签名生成。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
农行支付环境接口配置
安装jdk
2.安装Tomcat。
在catalina.sh中设置环境变量：
export JA V A_HOME=/opt/IBM/was6admin/jdk(根据实际安装路径来设置)
export JA V A_OPTS=" -Xms256m -Xmx1024m"
在$CA TALINA_HOME\bin下命令行方式下，敲入：./catalina.sh start启动服务器，然后在浏览器中键入地址http://127.0.0.1:8080/axis/，查看能否正常启动。
Web Services接口应用配置
1)、将银行提供的接口开发软件包TrustPayClient-B2C-PHP-Vx.x.x.zip（x.x为接口开发软件包的版本号）解压缩到商户自定的安装目录中。
2)、请参考《农行网上支付平台-商户使用手册V1.0》登录网上支付平台下载商户交易证书，并将商户交易证书保存到服务器的硬盘或签名服务器中。
3)、将商户的证书文件夹Certificate放入$CA TALINA_HOME\bin目录下，包括商户服务器证书*.pfx，农行根证书abc.truststore(生产环境证书，测试环境证书为abctest.truststore)和支付平台证书TrustPay.cer (生产环境证书，测试环境证书为TrustPayTest.cer)。
4)将TrustMerchant.properties文件放置到$CA TALINA_HOME\webapps\axis\WEB-INF\classes 目录下，该文件包含银行端访问地址，商户id,相关证书路径，证书密码的配置，日志路径等。
商户需要注意进行正确的配置（具体参考配置文件说明）。
将该TrustPayClient-Vx.x.jar 文件放入$CA TALINA_HOME\webapps\axis\WEB-INF\lib下。
5将Web Services接口包WebServices_b2c_php_vx.x.jar放入$CA TALINA_HOME\webapps\axis\WEB-INF\lib下。
在lib下加入包jcert.jar，jnet.jar，jsse.jar。
6将Web Services配置文件server-config.wsdd放入$CA TALINA_HOME\webapps\axis\WEB-INF中。
7)、修改$CA TALINA_HOME\webapps\axis\WEB-INF的web.xml文件，添加log4j初始化的servlet配置，并在该目录下建立文件夹config，放置log4j.properties配置文件（该文件中，可以指定web services段代码日志输出格式及输出地址）。
这里我们默认的日志是放在$CA TALINA_HOME\logs下。
8)、将支付结果文件MerchantResult.jsp放在$CA TALINA_HOME\webapps\axis，这样支付成功后可通过这个页面回显给客户。
将身份验证结果文件IdentityV erifyResult.jsp放在$CA TALINA_HOME\webapps\axis，这样可通过这个页面将验证结果回显给客户。
9)、重新启动tomcat应用服务器。
10)、通过php调用web services接口，从而与农行电子商务系统进行交互。
4.将MerchantPayment.rar解压到网站www的目录下
5.将abcbank.php放到www\languages\zh_cn\payment
6.将abcbank1.php放到www\includes\modules\payment并名门为abcbank.php
7.将abcphp放到www目录下
8.在数据库库中执行abc.sql
9.进行测试。