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

目录

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 获取或发布 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和请求、响应的格式和流程，对XML格式有一定的了解。

1.3 商业术语

术语示例

商户账户平台账号仅用于记账。这是财付通自动分配的10位数字。

密钥是财付通和商户约定的32位字符串，用于保证通信不被篡改，用于计算签名时使用。

账号 财付通账号，目前支持两种格式：QQ号和账号

金额，默认为人民币，单位为分。 1000 表示 .00

2项目概述

2.1 行业背景

在电子商务中，商家、买家、中介服务商是交易活动的三个环节。买家购买商品并下订单，商家确认订单，买家通过中介服务向商家付款，商家发货并履行订单。在这个过程中，商家网站需要集成中间服务商的支付功能，让买家完成支付。作为专业的中介服务商，财付通不仅提供支付接口，还提供支付结果查询接口和订单查询接口，帮助商户记录支付交易，让商户更专注于产品服务。

商户的货款将按合同规定的T0至T7的频率结算至商户的银行账户，同时收取一定的手续费。这个过程由财付通自动完成，商户无需做相关开发工作。

2.2 接口介绍

接口名称 请求URL 功能描述 结果描述

支付接口

调用该接口时指定支付参数，完成买家账户到商户账户的支付，采用页面跳转交互方式和后台通知交互方式。返回结果有两种方式：一种方式是前台在返回后添加参数，以页面跳转的方式表示；一路返回给后端添加参数，要求后端收到通知后做出响应。

通知身份验证接口该接口及时

商户收到后台通知后，根据通知ID向财付通发起验证确认，并通过后台系统调用交互方式。财付通实时返回XML格式的具体通知内容。

2.3 业务实施流程

2.0 财付通调用支付接口进行支付后，将支付结果返回至首页，同时向商户服务器发送支付是否成功的通知。

3.0 商户服务器收到支付结果通知后，可以根据通知ID查询通知内容，确定支付成功后向用户发送提示消息。这可以进一步提高安全性并防止通过虚假支付成功结果进行欺诈。

3种交互模式

3.1 页面跳转交互方式

页面跳转交互方式是指商户系统与财付通系统之间的数据交互是通过用户的浏览器进行的，属于非实时的异步交互。

如果买家下订单购买产品，商家系统将生成支付链接。该链接将通过用户的浏览器跳转至财付通系统。财付通通过该链接获取支付请求的参数。本次支付请求采用页面跳转交易方式。

用户在财付通页面完成支付后，财付通跳转至商户系统。

3.2 后台系统调用交互方式

后台系统调用交互方式是指商户系统向财付通系统发送请求数据，并同步等待财付通系统处理完成后返回的响应数据。数据交互是商户服务器与财付通服务器之间的直接通信。一般请求采用http get或post，响应采用xml数据格式。

例如，当用户在商户系统中进行查询时，商户想要确认用户的订单支付是否成功，可以向服务器发送查询请求。财付通收到请求后，会将查询结果以xml格式返回给商户，商户对结果进行处理。显示给用户。

3.3 后台通知交互方式

后台通知交互方式是指财付通系统主动向商户系统发送通知数据，并同步等待商户系统处理完成后返回的响应数据。数据交互是财付通服务器与商户服务器直接通信。一般请求采用HTTP get或post，响应采用字符串格式。

如果用户使用财付通支付成功，财付通会在后台向商户系统发起通知。商户处理后返回成功，处理失败则返回失败或其他字符。

4 数据格式

4.1获取或发布

使用HTTP标准的GET或POST协议，为了保证接收方正确接收数据，如果传递的参数包含特殊字符（如&、=等），需要对其进行URL加密。

GET或POST一般用于页面跳转交互方式、后台系统调用方式请求、后台通知方式请求等请求和通知。

4.2XML数据格式

采用标准XML协议，所有参数仅存在于一层节点中，不使用多级节点嵌套。