《腾讯财付通接口的开发.doc》由会员分享，可在线阅读，更多相关《腾讯财付通接口的开发.doc（28页珍藏版）》请在金锄头文库上搜索。
1、财付通支付网关商户开发指南目 录1引言41.1文档概述41.2阅读对象41.3业务术语42方案概述42.1行业背景42.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后台通知结果反馈147.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交互模式207.4.3请求参数列表207.4.4应答参数列表217.5退款明细查询接口237.5.1业务功能237.5.2交互模式237.5.3请求参数列表237.5.4应答参数列表248实例269注意事项281 引言1.1 文档概述本文描述了财付通针对合作商户提供的支付解决方案，帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、
3、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。1.2 阅读对象合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程，对XML格式有所掌握。1.3 业务术语术语示例说明商户号1900000107机票平台的账号，只用于记账，由财付通自动分配的10位数字密钥9ba2380ad9b2aacb96bca514eda27ac9为保证通讯不被篡改，财付通与商户之间约定的32位字符串，算签名sign时使用账户财付通账户号，目前支持两种格式：qq号码和email账户金
4、额100000金额，默认为RMB，以分为单位。1000表示RMB10.002 方案概述2.1 行业背景在电子商务中，商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单，商家确认订单，买家通过中间服务方向商家支付货款，商家发货履行订单。在这个过程中商家的网站需要集成中间服务方的支付功能，让买家完成货款的支付。财付通作为一家专业的中间服务方除了提供支付接口外，还提供了支付结果查询接口和订单查询接口等，帮助商家记录货款的往来，让商家能把更多的精力集中到商品服务上。商户的货款会按照合同约定以T0T7的频率结算到商户的银行账户，同时收取手续费。这个过程由财付通自动完成，商户无需做相关开发
5、工作。2.2 接口介绍接口名请求URL功能说明结果说明支付接口https:/ 业务实现流程2.0调用支付接口进行支付后，财付通返回支付结果给前台页面，同时会向商户的服务器发送支付是否成功的通知3.0商户服务器在收到支付结果通知后可以根据通知ID查询通知内容，在确保支付成功后再向用户发送提示信息，这样可以进一步提高安全性，防止伪支付成功结果的诈骗。3 交互模式3.1 页面跳转交互模式页面跳转交互模式是指商户系统与财付通系统的数据交互通过用户浏览器中转进行，是一种非实时的异步交互。如买家下单买一个商品，商户系统会生成一个支付链接，此链接通过用户的浏览器跳转到财付通系统，财付通通过此链接获取支付请求
6、的参数，这个支付请求用的就是页面跳转交易模式。用户在财付通页面完成支付后，财付通通过return_url跳转到商户系统。3.2 后台系统调用交互模式后台系统调用交互模式是指商户系统向财付通系统发送请求数据，并同步等待财付通系统处理完毕后返回的响应数据。数据交互是商户服务器与财付通服务器直接通信，一般请求采用http的get或post，应答采用xml数据格式。如用户在商户系统查询时，商户要确认用户某个订单是否支付成功，可以在服务器上发送一个查询请求，财付通收到请求后把查询结果以xml格式返回给商户，商户处理结果后再显示给用户。3.3 后台通知交互模式后台通知交互模式是指财付通系统主动向商户系统发
7、送通知数据，并同步等待商户系统处理完毕后返回的响应数据。数据交互是财付通服务器与商户服务器直接通信，一般请求采用http的get或post，应答用字符串格式。如用户在财付通支付成功后，财付通会在后台通过notify_url向商户系统发起通知，商户处理后成功返回success，失败返回fail或其他字符。4 数据格式4.1 GET或POST采用HTTP标准的GET或POST协议，为了保证接收方接收数据正确，传递的参数如果存在特殊字符（如&、=等）需要进行URL Encode。GET或POST一般用于页面跳转交互模式的请求和通知、后台系统调用模式的请求、后台通知模式的请求。4.2 XML数据格式采
8、用标准XML协议，所有参数只存在一级节点中，不采用多级节点嵌套。0190000010908DB4A013A8B515349C307F1E448CE836一般有返回码retcode参数，0表示调用成功；非0表示调用失败，失败时结果不签名，只有retcode和返回信息retmsg。XML一般用于后台系统调用模式的应答。4.3 字符串格式直接以简单字符串作为数据内容，一般用于后台通知模式的接口反馈，表示处理是否成功。返回结果结果说明success处理成功，财付通系统收到此结果后不再进行后续通知fail或其他字符处理不成功，财付通收到此结果或者没有收到任何结果，系统通过补单机制（详见第6节）再次通知5
9、 数字签名为了保证数据传输过程中的数据真实性和完整性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。数字签名有两个步骤，先按一定规则拼接要签名的原始串，再选择具体的算法和密钥计算出签名结果。一般失败的结果不签名。5.1 签名原始串无论是用get、post还是xml，签名原始串组串方式都一致，除sign字段外，待签名参数按照字段名的ascii码从小到大排序后使用QueryString的格式（即key1=value1&key2=value2）拼接而成，空值不传递，不参与签名。 签名时字段名和字段值都采用原始值，不进行URL Encode。 签名的字段包括请求中有所的get或post字
10、段，除了接口中描述的字段外，还应包括请求中出现的其它字段。5.2 签名算法目前暂只支持MD5签名5.2.1 MD5签名MD5 是一种摘要生成算法，通过在签名原始串后加上商户通信密钥的内容，进行MD5运算，形成的摘要字符串即为签名结果。为了方便比较，签名结果统一转换为大写字符。MD5签名计算公式：sign = Md5(原字符串&key=商户密钥). toUpperCase如：签名原始串是：input_charset=GBK&partner=1900000109&total_fee=1商户密钥是：8db4a013a8b515349c307f1e448ce836签名的结果为：sign=md5(inp
11、ut_charset=GBK&partner=1900000109&total_fee=1&key=8934e7d15453e97507ef794cf7b0519d)= 8DB4A013A8B515349C307F1E448CE8366 补单机制对后台通知交互模式，如果财付通收到商户的应答不是success或超时，财付通认为通知失败，财付通会通过一定的策略（如1分钟、2分钟、4分钟、8分钟、16分钟、32分钟，共6次）定期重新发起通知，尽可能提高通知的成功率,但财付通不保证通知最终能成功。由于存在重新发送后台通知的情况，因此同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知
12、。财付通推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回success。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。7 接口7.1 支付接口7.1.1 业务功能买家在商户网站拍下商品后，选择财付通付款，商户系统调用财付通支付接口，页面跳转到财付通支付中心或银行。用户完成支付后，财付通把用户引导回商户页面（return_url），同时服务器后台通知商户服务器（notify_url）支付结果。7.1.2 交互模式请求：页面跳转交互模式返回结果+通知：页面跳转交互模式+后台通知交互模式7.1.3 请求参数列表请求url：https:/
