财付通api接口

财付通 API 接口文档样例代码 引言 文档概述 本文描述了财付通开放平台的 JAVA SDK，帮助开发者轻松实现在线支付、收付款等功能。文档 详细介绍了财付通开放平台的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也 可以作为日后接口参数以及参数类型的速查手册。 阅读对象 具有 WEB 程序开发背景，了解 JAVA 语言。 业务术语 术语 ISV 说明 独立软件供应商 / Independent Software Vendor，可以是商户、个人或者第三方中介开发者 指 ISV 使用财付通开放平台 SDK 开发的 WEB 应用程序， 运行于第三方服务器上为最终用户提供 服务 指财付通的商户，商家可以是 ISV。 财付通提供给 ISV 的开发注册、应用管理、沙箱测试平台。 指通过财付通开放平台使用财付通 APP 的财付通用户 财付通 APP 商户 开放平台 最终用户 接口业务流程 支付流程 支付流程中， 用户在财付通 APP 中购买业务， 通过财付通支付平台进行支付。 典型业务流程如下： 买家在财付通 APP 上浏览下单购买一个商品，财付通 APP 会生成一个支付链接，此链接通过用 户的浏览器跳转到财付通开放平台，财付通通过此链接获取支 付请求的参数，引导用户完成支付过程。 用户在财付通完成支付后， 财付通通过 return_url 将用户浏览重新定向到财付通 APP， 财付通 APP 向用户提示订单状态和后续操作。同时，财付通会通过后台回调财付通 APP 的 notify_url，财付通 APP 在 收到支付结果通知后可以根据通知 ID 查询通知内容，在确保支付成功后再进行业务逻辑处理（例如发货） ， 这样可以进一步提高安全性，防止伪支付成功结果的诈骗。 通知查询/订单查询流程 通知查询/订单查询是指财付通 APP 向财付通系统发送查询请求，并同步等待财付通系统处理完 毕后返回的响应数据。数据交互是财付通 APP 与财付通服务器直接通信。 例如用户在财付通 APP 查询时，财付通 APP 要确认用户某个订单是否支付成功，可以向财付通 发送一个查询请求，财付通收到请求后返回查询结果，财付通 APP 处理结果后再显示给用户。 后台通知流程 后台通知是指财付通系统主动向财付通 APP 发送通知数据，并同步等待财付通 APP 处理完毕后 返回的响应数据。数据交互是财付通服务器与财付通 APP 直接通信，一般请求采用 http 的 get 或 post， 应答用字符串格式。 用户在财付通支付成功后，财付通会在后台通过 notify_url 向财付通 APP 发起通知，财付通 APP 处理后成功返回 success，失败返回 fail 或其他字符。 补单机制 对后台通知流程， 如果财付通收到财付通 APP 的应答不是 success 或由于网络异常超时， 财付通 认为通知失败，财付通会通过一定的策略（如1分钟、2分钟、4分钟、8分钟、16分钟、32分钟，共6次） 定期重新发起通知，尽可能提高通知的成功率，但财付通不保证通知最终能成功。 由于上述原因，可能存在同样的通知多次发送给财付通 APP 的情况。财付通 APP 必须能够正确 处理，在收到重复的后台通知不重复引发业务流程（例如发货） 。 财付通推荐的做法是，当收到财付通发送的通知消息时，需要检查本系统内订单的状态，判断该 通知是否已经处理过。为防止并发产生的问题，在对业务数据进行状态检查和处理之前，要求采用加锁判 断进行并发控制。 功能划分 财付通 APP 负责与之业务相关的代码和页面。 财付通开放平台提供支付相关的业务功能和页面。具体业务功能请参照后面章节 SDK 说明 支付页面如下： 在小钱包中： 在普通浏览器中： SDK 说明 概述 API 说明 类名 com.tenpay.api.PayRequest com.tenpay.api.PayResponse com.tenpay.api.OrderQueryRequest com.tenpay.api.OrderQueryResponse com.tenpay.api.NotifyQueryRequest com.tenpay.api.NotifyQueryResponse com.tenpay.api.ShareLoginState 共享登录用户信息接口： ? 用户跳转到应用时，初始化 ShareLoginState 对象,ShareLoginState.getUserId()即可获得当前用 说明 支付请求 支付响应 订单查询请求 订单查询响应 通知查询请求 通知查询响应 共享登录用户信息 户的 id 支付接口，常见开发步骤如下： ? ? ? ? ? 初始化请求对象 PayRequest 设置请求系统级参数（应用 ID 等） ，例如 PayRequest.setAppid(应用 ID) 设置请求业务级参数，例如 PayRequest.setParameters(参数名称, 参数值) 生成跳转 URL，例如 PayRequest.getURL() 将用户重定向到跳转 URL，例如 Servlet/JSP 中的重定向方法 response.sendRedirect()或用 Javascript 进行页面跳转 通知查询或订单查询，常见开发步骤如下： ? ? ? 初始化请求对象，例如 NotifyQueryRequest 或 OrderQueryRequest 设置请求系统级参数（应用 ID 等） ，例如 NotifyQueryRequest.setAppid(应用 ID) 设置请求业务级参数，例如 NotifyQueryRequest.setParameters(参数名称, 参数值) ?? 通 过 NotifyQueryRequest.send() 方 法 将 请 求 发 送 到 接 口 并 获 得 响 应 对 象 ， 例 如 NotifyQueryResponse response = NotifyQueryRequest.send() ?? 判断订单支付状态，例如 NotifyQueryResponse.isPaySuccessful() ?? 从响应对象中获取参数值，进行相应处理，例如 NotifyQueryResponse.getParameter(参数名) 后台通知交互模式，常见开发步骤如下： ?? 构造一个 Servlet 或 JSP 接收开放平台的回调 ?? 初始化响应对象 PayResponse ?? 判断订单支付状态，例如 PayResponse.isPaySuccessful() ?? 从响应对象中获取参数值，进行相应处理，例如 PayResponse.getParameter(参数名) 调用过程 支付类 支付跳转 ·业务功能 买家在财付通 APP 中下订单后付款，财付通 APP 调用财付通开放平台支付接口生成支付 URL， 页面跳转到财付通支付中心或银行。用户完成支付后，财付通把用户引导回财付通 APP 指定的页面 （return_url） ，并通过回调支付请求中的 notify_url 反馈支付结果。 ·接口调用方向 开发者开发应用调用财付通开放接口 ·请求 com.tenpay.api.NotifyQueryRequest 方法列表 /** * 构造方法