《财付通接口文档及代码》由会员分享，可在线阅读，更多相关《财付通接口文档及代码（15页珍藏版）》请在金锄头文库上搜索。
1、财付通API接口文档样例代码引言 文档概述本文描述了财付通开放平台的JAVA SDK，帮助开发者轻松实现在线支付、收付款等功能。文档 详细介绍了财付通开放平台的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也 可以作为日后接口参数以及参数类型的速查手册。阅读对象具有WEB程序开发背景，了解JAVA语言。业务术语术语说明ISV独立软件供应商/ Independent Software Vendor，可以是商户、个人或者第三方中介开发者财付通APP指ISV使用财付通开放平台SDK开发的WEB应用程序，运行于第三方服务器上为最终用户提供 服务商户指财付通的商户，商家可以是ISV。开
2、放平台财付通提供给ISV的开发注册、应用管理、沙箱测试平台。最终用户指通过财付通开放平台使用财付通APP的财付通用户接口业务流程支付流程支付流程中，用户在财付通APP中购买业务，通过财付通支付平台进行支付。典型业务流程如下:i下口单11J1F*1i111!二 土朮订单弓支航i总111111U- 1kII離转到支村接口瓷戒支忖操柞I1.I将用户请求境定勺蚕财忖逍A冲史囱i*-1 TV W 1W T7 -f_ JI进廿后纭操忙I1通过tLQiliyurl反慵通知夜窗10!确誠临色谄匹_I话屈罰蕊五P誌1石蘇返回订已倍息买家在财付通 APP 上浏览下单购买一个商品，财付通 APP 会生成一个支付链接
3、，此链接通过用 户的浏览器跳转到财付通开放平台，财付通通过此链接获取支付请求的参数，引导用户完成支付过程。用户在财付通完成支付后，财付通通过return_url将用户浏览重新定向到财付通APP,财付通APP 向用户提示订单状态和后续操作。同时，财付通会通过后台回调财付通APP的notify_url,财付通APP在 收到支付结果通知后可以根据通知ID查询通知内容，在确保支付成功后再进行业务逻辑处理（例如发货）， 这样可以进一步提高安全性，防止伪支付成功结果的诈骗。通知查询/订单查询流程通知查询/订单查询是指财付通 APP 向财付通系统发送查询请求，并同步等待财付通系统处理完 毕后返回的响应数据。
4、数据交互是财付通APP与财付通服务器直接通信。例如用户在财付通APP查询时，财付通APP要确认用户某个订单是否支付成功，可以向财付通 发送一个查询请求，财付通收到请求后返回查询结果，财付通APP处理结果后再显示给用户。后台通知流程后台通知是指财付通系统主动向财付通APP发送通知数据，并同步等待财付通APP处理完毕后 返回的响应数据。数据交互是财付通服务器与财付通APP直接通信，一般请求采用http的get或post， 应答用字符串格式。用户在财付通支付成功后，财付通会在后台通过notify_url向财付通APP发起通知，财付通APP 处理后成功返回success，失败返回fail或其他字符。补
5、单机制对后台通知流程，如果财付通收到财付通APP的应答不是success或由于网络异常超时，财付通 认为通知失败，财付通会通过一定的策略（如1分钟、2分钟、4分钟、8分钟、16分钟、32分钟，共6次） 定期重新发起通知，尽可能提高通知的成功率，但财付通不保证通知最终能成功。由于上述原因，可能存在同样的通知多次发送给财付通APP的情况。财付通APP必须能够正确 处理，在收到重复的后台通知不重复引发业务流程（例如发货）。财付通推荐的做法是，当收到财付通发送的通知消息时，需要检查本系统内订单的状态，判断该 通知是否已经处理过。为防止并发产生的问题，在对业务数据进行状态检查和处理之前，要求采用加锁判
6、断进行并发控制。功能划分财付通 APP 负责与之业务相关的代码和页面。财付通开放平台提供支付相关的业务功能和页面。具体业务功能请参照后面章节 SDK 说明支付页面如下： 在小钱包中：就fj问首页T，深圳电影票/支付中心欢迎您,Aixxia反馈 帮助本次交易额元直接支付给Aixxia您购买的是：丈平洋电參票财付通余额支忖网上银行支付一点通支付E1应付总价：33.0(元财忖通账户名:943259136财忖通余颔:831.99 元财付通支付密码：|忘记支忖密码？在普通浏览器中：克村时声it交册ts 33.00元聃吏村猜au旳愆购罠的是：田文平滞电勰一血通支忖没打用I.诅行？应村忌价;拓一 O(Jj宮
7、记夏时玄馬7关于宙卅環I is駅中心|皆陆申心| at证至才|席尸冠全|联禾物mCopightO 1 E盟-201 a Tancanr All Rlghls Rerved KiHifrfl 书权屛有SDK 说明概述API 说明类名说明com.tenpay.api.PayRequest支付请求com.tenpay.api.PayResponse支付响应com.tenpay.api.OrderQueryRequest订单查询请求com.tenpay.api.OrderQueryResponse订单查询响应com.tenpay.api.NotifyQueryRequest通知查询请求com.tenp
8、ay.api.NotifyQueryResponse通知查询响应com.tenpay.api.ShareLoginState共享登录用户信息共享登录用户信息接口：1 用户跳转到应用时，初始化ShareLoginState对象,ShareLoginState.getUserld（）即可获得当前用 户的id支付接口，常见开发步骤如下：2 初始化请求对象PayRequest3 设置请求系统级参数（应用ID等），例如PayRequest.setAppid（应用ID）4 设置请求业务级参数，例如PayRequest.setParameters（参数名称，参数值）5 生成跳转 URL，例如 PayRequ
9、est.getURL（）6 将用户重定向到跳转 URL，例如Servlet/JSP中的重定向方法response.sendRedirect（）或用Javascript 进行页面跳转通知查询或订单查询，常见开发步骤如下：7 初始化请求对象，例如 NotifyQueryRequest 或 OrderQueryRequest8 设置请求系统级参数（应用ID等），例如NotifyQueryRequest.setAppid（应用ID）9 设置请求业务级参数，例如NotifyQueryRequest.setParameters（参数名称，参数值）10通过NotifyQueryRequest.send（）方
10、法将请求发送到接口并获得响应对象，例如NotifyQueryResponse response = NotifyQueryRequest.send（）11 判断订单支付状态，例如 NotifyQueryResponse.isPaySuccessful（）12 从响应对象中获取参数值，进行相应处理，例如NotifyQueryResponse.getParameter（参数名）后台通知交互模式，常见开发步骤如下：13 构造一个 Servlet 或 JSP 接收开放平台的回调14 初始化响应对象 PayResponse15 判断订单支付状态，例如 PayResponse.isPaySuccessfu
11、l（）16 从响应对象中获取参数值，进行相应处理，例如PayResponse.getParameter（参数名）调用过程PmyRBfjuBEt. fstURLO5、朕转到财启適完成支忖揆柞4、产生支伽I,引导用 到St忖注支忖页面2、陳转财忖通APP, Shard-OMinStats. EeUtkldt)I氛 盍忖完成桃轅回紳卩异歩/获哦連知IDIIPayResponae. g-etNot ify Id() I谓务必部杵段收通撼后I调用此方法，,否胃申忖通精违读发送 1遽知. q_JI iV* 卩自ylR鹽pqtie& krtv I edgeStmcl cssb 0取通知验证菠取订单信息Hot
12、 i fyQutsryRaquest. ndOlEfsyadO* 唯一衷明KI養fd完成的方法 严回tF上舒圭忖完咸9.判断是宵完成支怕 ifyQutryRcspornie isPa yed Q, 完咸APP内部逻辑g同矿，页面骁转冋rsturn_ur I 不.亓单号可取从aesaim获取”战老通过通知ID验证(查询)荻取支付类支付跳转业务功能买家在财付通 APP 中下订单后付款，财付通 APP 调用财付通开放平台支付接口生成支付 URL 页面跳转到财付通支付中心或银行。用户完成支付后，财付通把用户引导回财付通 APP 指定的页面(return_url),并通过回调支付请求中的notify_u
13、rl反馈支付结果。接口调用方向开发者开发应用调用财付通开放接口 请求com.tenpay.api.NotifyQueryRequest方法列表/*构造方法* param secretKey*/通知查询请求public NotifyQueryRequest(String secretKey);/*设置应用ID* param appid* 应用ID*/public void setAppid(String appid);/*设置是否在沙箱环境* param inSandBox* true表示请求发送到沙箱环境，false表示请求发送到正式环境*/public void setlnSandBox(b
14、oolean inSandBox);/*设置业务参数* param key* 参数名称* param value* 参数值*/public void setParameter(String key, String value);/*调用开放平台接口发送请求，获取响应* return接口调用的返回结果* throws Exception*/public CommonResponse send() throws Exception;参数名称详见下表参数名称必填类型说明notify_id是String(64 )支付成功后，财付通系统反馈的通知ID此参数来源详见3.125章节参数列表中的 notify_idsign_key_index否Int多密钥支持的密钥序号，默认1sign_type否String(8)签名类型，取值：MD5、RSA，默认：MD5，暂只支持MD5service_versio n否String(8)版本号，默认为1.0返回结果com.tenpay.api.NotifyQueryResponse 通知查询响应方法列表/*判断支付结果*
