财付通开发接口,支付接口,通知查询接口,订单查询接口,退款接口,退款明细查询接口,对账单下载接口文档.doc-资料库

u011855773-8313327-4744302543008375377.doc.pdf-第1页.png

第1页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第2页.png

第2页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第3页.png

第3页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第4页.png

第4页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第5页.png

第5页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第6页.png

第6页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第7页.png

第7页 / 共33页

u011855773-8313327-4744302543008375377.doc.pdf-第8页.png

第8页 / 共33页

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

目录 1 引言 .............................................................. 4 1.1 文档概述 ............................................................................ 4 1.2 阅读对象 ............................................................................ 4 1.3 业务术语 ............................................................................ 4 2 方案概述 ...........................................................5 2.1 行业背景 ............................................................................ 5 2.2 接口介绍 ............................................................................ 5 2.3 业务实现流程 ........................................................................ 6 3 交互模式 ...........................................................6 3.1 页面跳转交互模式 .................................................................... 6 3.2 后台系统调用交互模式 ................................................................ 7 3.3 后台通知交互模式 .................................................................... 8 4 数据格式 ...........................................................8 4.1 GET 或 POST .......................................................................... 8 4.2 XML 数据格式 ........................................................................ 8 4.3 字符串格式 .......................................................................... 9 5 数字签名 ...........................................................9 5.1 签名原始串 .......................................................................... 9 5.2 签名算法 ........................................................................... 10 5.2.1 MD5 签名 ..................................................................... 10 5.2.2 RSA 签名 ..................................................................... 11 6 补单机制 ..........................................................11 7 接口 ............................................................. 12 7.1 支付接口 ........................................................................... 12 7.1.1 业务功能 ..................................................................... 12

7.1.2 交互模式 ..................................................................... 12 7.1.3 请求参数列表 ................................................................. 12 7.1.4 返回结果和通知参数列表 ....................................................... 14 7.1.5 后台通知结果反馈 ............................................................. 15 7.2 通知查询接口 ....................................................................... 16 7.2.1 业务功能 ..................................................................... 16 7.2.2 交互模式 ..................................................................... 16 7.2.3 请求参数列表 ................................................................. 16 7.2.4 应答参数列表 ................................................................. 16 7.3 订单查询接口 ....................................................................... 18 7.3.1 业务功能 ..................................................................... 18 7.3.2 交互模式 ..................................................................... 18 7.3.3 请求参数列表 ................................................................. 18 7.3.4 应答参数列表 ................................................................. 19 7.4 退款接口 ........................................................................... 21 7.4.1 业务功能 ..................................................................... 21 7.4.2 交互模式 ..................................................................... 22 7.4.3 请求参数列表 ................................................................. 22 7.4.4 应答参数列表 ................................................................. 23 7.5 退款明细查询接口 ................................................................... 24 7.5.1 业务功能 ..................................................................... 24 7.5.2 交互模式 ..................................................................... 25 7.5.3 请求参数列表 ................................................................. 25 7.5.4 应答参数列表 ................................................................. 26 7.6 对账单下载接口 ..................................................................... 28 7.6.1 业务功能 ..................................................................... 28 7.6.2 交互模式 ..................................................................... 28 7.6.3 请求参数列表 ................................................................. 28 7.6.4 应答参数列表 ................................................................. 29

8 实例 ............................................................. 30 9 风控策略 ..........................................................32 10 注意事项 ..........................................................33 1 引言 1.1 文档概述本文描述了财付通针对合作商户提供的支付解决方案，帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。 1.2 阅读对象合作商户系统的技术开发人员，要求具有 WEB 程序开发背景，了解 http 和 https 请求和应答的格式和过程，对 XML 格式有所掌握。接口调试过程中经常遇到的一些问题可以参考 http://bbs.tenpay.com 和 http://help.tenpay.com 进行解决。 1.3 业务术语术语示例说明商户号 1200000107 机票平台的账号，只用于记账，由财付通自动分配的 10 位数字密钥 9ba2380ad9b2aacb96bca514eda27ac9 为保证通讯不被篡改，财付通与商户之间约定的 32 商户 RSA RSAprivateKey 商户的 RSA 私钥，用于生成签名位字符串，算签名 sign 时使用私钥财付通 RSA TenpayPublicKey 财付通的 RSA 公钥，用于解签。

公钥账户 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 调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式通知查询接口 https://gw.tenpay.com/ gateway/verifynotifyid .xml 商户在收到后台通知后根据通知 ID 向财付通发起通知内容的查询，采用后台系统调用交互模式结果分两路返回：一路为前台在 return_url 后添加参数返回，表现为页面跳转；一路为后台在 notify_url 后添加参数返回，要求后台 notify_url 收到通知后进行响应。财付通把具体的通知内容按 XML 格式实时返回订单查询接口 https://gw.tenpay.com/ gateway/normalorderque ry.xml 商户在后台对任意一笔订单发起查询，采用后台系统调用交互模式根据订单号以 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.1 GET 或 POST 采用 HTTP 标准的 GET 或 POST 协议，为了保证接收方接收数据正确，传递的参数如果存在特殊字符（如&、 =等）需要进行 URL Encode。 GET 或 POST 一般用于页面跳转交互模式的请求和通知、后台系统调用模式的请求、后台通知模式的请求。 4.2 XML 数据格式采用标准 XML 协议，所有参数只存在一级节点中，不采用多级节点嵌套。 0 1900000109

资料库

财付通开发接口,支付接口,通知查询接口,订单查询接口,退款接口,退款明细查询接口,对账单下载接口文档.doc

相关推荐

开发技术

热门标签

最新资料