财付通(一)

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

目 录
1 引言 3
1.1 文档概述 3
1.2 阅读对象 3
1.3 业务术语 4
2 方案概述 4
2.1 行业背景 4
2.2 接口介绍 4
2.3 业务实现流程 5
3 交互模式 6
3.1 页面跳转交互模式 6
3.2 后台系统调用交互模式 6
3.3 后台通知交互模式 7
4 数据格式 7
4.1 GET或POST 7
4.2 XML数据格式 8
4.3 字符串格式 8
5 数字签名 8
5.1 签名原始串 9
5.2 签名算法 9
5.2.1 MD5签名 9
6 补单机制 9
7 接口 10
7.1 支付接口 10
7.1.1 业务功能 10
7.1.2 交互模式 10
7.1.3 请求参数列表 10
7.1.4 返回结果和通知参数列表1 13
7.1.5 返回结果和通知参数列表2 15
7.1.6 后台通知结果反馈 16
7.2 通知id验证接口 16
7.2.1 业务功能 16
7.2.2 交互模式 16
7.2.3 请求参数列表 17
7.2.4 应答参数列表 17
8 实例 18
9 注意事项 20
1引言
1.1文档概述
本文描述了财付通针对合作商户提供的支付解决方案，帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。
1.2阅读对象
合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程，对XML格式有所掌握。

1.3业务术语
术语 示例 说明
商户号 1900000107 平台的账号，只用于记账，由财付通自动分配的10位数字
密钥 9ba2380ad9b2aacb96bca514eda27ac9 为保证通讯不被篡改，财付通与商户之间约定的32位字符串，算签名sign时使用
账户 jpgyf@qq.com 财付通账户号，目前支持两种格式：qq号码和email账户
金额 100000 金额，默认为RMB，以分为单位。1000表示RMB10.00
2方案概述
2.1行业背景
在电子商务中，商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单，商家确认订单，买家通过中间服务方向商家支付货款，商家发货履行订单。在这个过程中商家的网站需要集成中间服务方的支付功能，让买家完成货款的支付。财付通作为一家专业的中间服务方除了提供支付接口外，还提供了支付结果查询接口和订单查询接口等，帮助商家记录货款的往来，让商家能把更多的精力集中到商品服务上。
商户的货款会按照合同约定以T0～T7的频率结算到商户的银行账户，同时收取手续费。这个过程由财付通自动完成，商户无需做相关开发工作。
2.2接口介绍
接口名 请求URL 功能说明 结果说明
支付接口 https://gw.tenpay.com/gateway/pay.htm
调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式 结果分两路返回：一路为前台在return_url后添加参数返回，表现为页面跳转；一路为后台在notify_url后添加参数返回，要求后台notify_url收到通知后进行响应。
通知id验证接口 https://gw.tenpay.com/gateway/simpleverifynotifyid.xml 此接口有时效性
商户在收到后台通知后根据通知ID向财付通发起验证确认，采用后台系统调用交互模式 财付通把具体的通知内容按XML格式实时返回
2.3业务实现流程

2.0调用支付接口进行支付后，财付通返回支付结果给前台页面，同时会向商户的服务器发送支付是否成功的通知
3.0商户服务器在收到支付结果通知后可以根据通知ID查询通知内容，在确保支付成功后再向用户发送提示信息，这样可以进一步提高安全性，防止伪支付成功结果的诈骗。
3交互模式
3.1页面跳转交互模式
页面跳转交互模式是指商户系统与财付通系统的数据交互通过用户浏览器中转进行，是一种非实时的异步交互。
如买家下单买一个商品，商户系统会生成一个支付链接，此链接通过用户的浏览器跳转到财付通系统，财付通通过此链接获取支付请求的参数，这个支付请求用的就是页面跳转交易模式。
用户在财付通页面完成支付后，财付通通过return_url跳转到商户系统。

3.2后台系统调用交互模式
后台系统调用交互模式是指商户系统向财付通系统发送请求数据，并同步等待财付通系统处理完毕后返回的响应数据。数据交互是商户服务器与财付通服务器直接通信，一般请求采用http的get或post，应答采用xml数据格式。
如用户在商户系统查询时，商户要确认用户某个订单是否支付成功，可以在服务器上发送一个查询请求，财付通收到请求后把查询结果以xml格式返回给商户，商户处理结果后再显示给用户。

3.3后台通知交互模式
后台通知交互模式是指财付通系统主动向商户系统发送通知数据，并同步等待商户系统处理完毕后返回的响应数据。数据交互是财付通服务器与商户服务器直接通信，一般请求采用http的get或post，应答用字符串格式。
如用户在财付通支付成功后，财付通会在后台通过notify_url向商户系统发起通知，商户处理后成功返回success，失败返回fail或其他字符。

4数据格式
4.1GET或POST
采用HTTP标准的GET或POST协议，为了保证接收方接收数据正确，传递的参数如果存在特殊字符（如&、=等）需要进行URL Encode。
GET或POST一般用于页面跳转交互模式的请求和通知、后台系统调用模式的请求、后台通知模式的请求。
4.2XML数据格式
采用标准XML协议，所有参数只存在一级节点中，不采用多级节点嵌套。