财付通支付网关商户开发指南

《财付通支付网关商户开发指南》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、财付通支付网关商户开发指南目录1引言41.1文档概述41.2阅读对象41.3业务术语42方案概述52.1行业背景52.2接口介绍52.3业务实现流程63交互模式63.1页面跳转交互模式63.2后台系统调用交互模式73.3后台通知交互模式84数据格式84.1GET或POST84.2XML数据格式94.3字符串格式95数字签名95.1签名原始串105.2签名算法105.2.1MD5签名106补单机制107接口117.1支付接口117.1.1业务功能117.1.2交互模式117.1.3请求参数列表117.1.4返回结果和通知参数列表137.1.5后台通知结果反馈157.2通知查询接口157.2.1

2、业务功能157.2.2交互模式157.2.3请求参数列表157.2.4应答参数列表167.3订单查询接口177.3.1业务功能177.3.2交互模式177.3.3请求参数列表177.3.4应答参数列表187.4退款接口207.4.1业务功能207.4.2交互模式217.4.3请求参数列表217.4.4应答参数列表227.5退款明细查询接口237.5.1业务功能237.5.2交互模式237.5.3请求参数列表247.5.4应答参数列表257.6对账单下载接口267.6.1业务功能267.6.2交互模式267.6.3请求参数列表277.6.4应答参数列表278实例289风控策略3010注意事项3

3、11引言1.1文档概述本文描述了财付通针对合作商户提供的支付解决方案，帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。1.2阅读对象合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程，对XML格式有所掌握。接口调试过程中经常遇到的一些问题可以参考http://bbs.tenpay.com和http://help.tenpay.com进行解决。1.3业务术语术语示例说明商户号190000

4、0109财付通账号，只用于记账，由财付通自动分配的10位数字密钥8934e7d15453e97507ef794cf7b0519d为保证通讯不被篡改，财付通与商户之间约定的32位字符串，算签名sign时使用账户jpgyf@qq.com财付通账户号，目前支持两种格式：qq号码和email账户金额100000金额，默认为RMB，以分为单位。1000表示RMB10.001方案概述1.1行业背景在电子商务中，商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单，商家确认订单，买家通过中间服务方向商家支付货款，商家发货履行订单。在这个过程中商家的网站需要集成中间服务方的支付功能，让买家完成

5、货款的支付。财付通作为一家专业的中间服务方除了提供支付接口外，还提供了支付结果查询接口和订单查询接口等，帮助商家记录货款的往来，让商家能把更多的精力集中到商品服务上。商户的货款会按照合同约定以T0～T7的频率结算到商户的银行账户，同时收取手续费。这个过程由财付通自动完成，商户无需做相关开发工作。1.2接口介绍接口名请求URL功能说明结果说明支付接口https://gw.tenpay.com/gateway/pay.htm调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式结果分两路返回：一路为前台在return_url后添加参数返回，表现为页面跳转；

6、一路为后台在notify_url后添加参数返回，要求后台notify_url收到通知后进行响应。通知查询接口https://gw.tenpay.com/gateway/verifynotifyid.xml商户在收到后台通知后根据通知ID向财付通发起通知内容的查询，采用后台系统调用交互模式财付通把具体的通知内容按XML格式实时返回订单查询接口https://gw.tenpay.com/gateway/normalorderquery.xml商户在后台对任意一笔订单发起查询，采用后台系统调用交互模式根据订单号以XML格式返回具体的订单内容和状态退款接口https://mch.tenpay.com

7、/refundapi/gateway/refund.xml商户在后台对一笔已支付订单发起退款，采用后台系统调用交互模式退款成功、失败或者退款流程中的结果实时返回退款明细查询接口https://gw.tenpay.com/gateway/normalrefundquery.xml根据退款ID查询具体的退款明细退款明细数据实时返回1.1业务实现流程2.0调用支付接口进行支付后，财付通返回支付结果给前台页面，同时会