财付通接口文档及代码财付通接口文档及代码
财付通API接口文档样例代码
引言
文档概述
阅读对象
具有WEB程序开发背景,了解JAVA语言。
业务术语
接口业务流程
支付流程
支付流程中,用户在财付通APP中购买业务,通过财付通支付平台进行支付。典型业务流程如下:
买家在财付通APP上浏览下单购买一个商品,财付通APP会生成一个支付链接,此链接通过用户的浏览器跳转到财付通开放平台,财付通通过此链接获取支付请求的参数,引导用户完成支付过程。 用户在财付通完成支付后,财付通通过return_url将用户浏览重新定向到财付通APP,...
财付通接口文档及代码
财付通API接口文档样例代码
引言
文档概述
阅读对象
具有WEB程序开发背景,了解JAVA语言。
业务术语
接口业务流程
支付流程
支付流程中,用户在财付通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必须能够正确处理,在收到重复的后台通知不重复引发业务流程(例如发货)。
财付通推荐的做法是,当收到财付通发送的通知消息时,需要检查本系统
支付页面如下:
在小钱包中:
在普通浏览器中:
SDK说明
概述
API说明
共享登录用户信息接口:
用户跳转到应用时,初始化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反馈支付结果。
?接口调用方向
开发者开发应用调用财付通开放接口
?请求
参数名称详见下表
?返回结果
参数名称详见下表
?样例
订单查询
?业务功能
根据商户订单号或者财付通订单号查询财付通侧记录的具体订单信息。
?接口调用方向
开发者开发应用调用财付通开放接口。
?请求
参数名称详见下表
?返回结果
订单查询返回结果与通知查询返回结果相同,参见“通知验证返回结果”
?样例
其他类
共享登录
?业务功能
买家转到APP中时,系统将买家的ID传入APP,方便用户订单生成、用户状态更新等相关操作。 ?交互模式
买家点击跳转到APP时,id等相关信息将签名后通过url一起发往APP。
?样例
银行编码
本文档为【财付通接口文档及代码】,请使用软件OFFICE或WPS软件打开。作品中的文字与图均可以修改和编辑,
图片更改请在作品中右键图片并更换,文字修改请直接点击文字进行修改,也可以新增和删除文档中的内容。
[版权声明] 本站所有资料为用户分享产生,若发现您的权利被侵害,请联系客服邮件isharekefu@iask.cn,我们尽快处理。
本作品所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用。
网站提供的党政主题相关内容(国旗、国徽、党徽..)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。