以下为《天府支付聚合支付开发指南1.5》的无排版文字预览，完整内容请下载
天府支付
聚合支付开发指南
四川天府银行
天府支付
目录
编写说明 4
1. 文档概述 1
2. 阅读对象 1
3. 业务术语 1
4. 规范及定义 1
1.1. 商户订单号 1
1.2. 订单防重 1
1.3. 接口规范 1
1.4. 请求头需求 2
5. 签名机制 2
1.5. 签名原始串 2
1.6. 2签名算法 3
1.7. 签名 3
6. 通知机制 4
7. 接口 4
7.1. 提现-申请接口 4
7.2. 提现-申请查询接口 5
7.3. 动态一码付接口 5
7.4. 聚合支付接口 7
7.5. 支付-异步通知 14
7.6. 订单查询接口 16
7.7. 对账单下载接口 17
7.8. 通知ID查询接口 18
7.9. 聚合支付退款接口 19
7.10. 结算信息汇总数据 21
7.11. 交易数据查询接口 22
7.12. 余额与待清算金额查询 23
7.13. 特约商户入驻接口 24
7.14. 特约商户入驻更改 26
7.15. 特约商户入驻查询 28
7.16. 特约商户基本信息修改申请 29
7.17. 商户入驻修改异步通知 30
7.18. 商户通道费率查询接口 31
7.19. 特约商户费率维护接口 32
7.20. 被扫交易-撤单接口 32
7.21. 预授权交易-冻结接口 34
7.22. 预授权交易-撤销接口 36
7.23. 预授权交易-解冻接口 37
7.24. 预授权交易-完成接口 38
7.25. 预授权交易-退款接口 39
7.26. 预授权交易-查询接口 40
7.27. 静态一码付-获取用户标识接口 42
7.28. 资金变动明细查询 43
7.29. 商户收款二维码查询 44
7.30. 订单关闭接口 45
8. 附录 46
8.1. 注意事项 46
8.2. 接口使用规则 46
8.3. 测试流程规则 46
8.4. 测试数据列表 46
8.5. 调试用具说明 47
8.6. 返回结果代码列表 48
8.7. 退款返回结果代码列表 50
8.8. 行业类目 50
8.9. 支付渠道说明 50
8.10. 业务异常描述 50
编写说明
标题：天府支付聚合支付开发指南
类别：文档
编辑软件：Microsoft Word 2013 中文版
版本历史：
版本日期作者更改内容
V1.02018-04-16李某某建立
V1.01
2018-04-27
李某某
1，调整7.4聚合支付请求参数与响应参数； 2，优化8.9支付渠道说明排版； 3，增加8.10业务异常描述；
V1.02
2018-04-28
李某某
优化 7.27,7.28静态一码付相关接口描述
V1.03
2018-04-28
李某某
更新测试环境请求地，去除端口号
V1.04
2018-04-28
李某某
7.27增加form表单参数列表
V1.05
2018-05-03
李某某
增加7.29资金变动明细查询接口
V1.06
2018-06-21
李某某
增加7.30商户收款二维码查询接口
V1.07
2018-09-04
曾朋
新增7.13特约商户入驻接口 商户事业部and客户经理字段
V1.08
2018-10-24
李某某
更新合单支付说明 更新测试环境接口地址域名
增加聚合支付报文示例
V1.1
2018-11-06
李某某
更新测试环境接口地址域名
V1.1.1
2018-11-13
李某某
优化文档编号、目录结构
V1.2
2018-11-14
李某某
新增7.4.4微信公众号支付说明
V1.2.1
2019-01-03
李某某
新增7.4聚合支付接口，针对微信公众号支付应答参数returnMsg参数的说明
V1.2.2
2019-01-15
李某某
优化文档部分描述，并增加异步通知通知方式
V1.2.3
2019-03-08
李某某
更新7.4.4.2时序图
V1.2.4
2019-03-14
李某某
7.4. 聚合支付接口增加微信单品优惠相关字段说明
7.5 支付-异步通知接口，增加微信单品优惠相关字段说明
7.6 订单查询接口，增加微信单品优惠相关字段说明
V1.3
2019-04-11
李某某
新增 7.31订单关闭接口
调整 7.9聚合支付退款接口 请求参数 平台订单号 为非必填字段
V1.3.1
2019-05-09
李某某
7.18特约商户基本信息修改接口，请求参数增加身份证反面字段
V1.3.2
2019-06-05
李某某
调整7.7对账文件下载，变更对账文件获取方式
V1.3.3
2019-06-012
李某某
预授权撤销、解冻、完成、退款、收单退款，接口增加remark字段
V1.3.4
2019-06-21
穆某某
7.6订单查询接口反参中增加trans_channel,pay_transno,bank_type字段7.5支付异步通知增加pay_transno，7.4聚合支付接口反参增加pay_transno,bank_type 7.13特约商户入驻接口入参结算周期增加D+0、D+3、D+7 7.14特约商户入驻更改请求入参结算周期增加D+0、D+3、D+7
V1.3.5
2019-06-28
穆某某
7.13特约商户入驻接口 7.14特约商户入驻更改 入参openbankcode
bankcode改为非必传，修改接口描述内容 7.16特约商户基本信息修改接口修改接口描述内容
V1.4
2019-07-02
穆某某
7.11交易数据查询接口请求参数列表增加字段transType,修改字段biz_type,clearingstate枚举，反参列表修改biz_type，clearingstate枚举
V1.4.1
2019-07-02
穆某某
8.9支付渠道增加银某某云闪付-JS支付（unionpay_jspay）
V1.4.3
2019-11-20
穆某某
7.7对账单文件下载新增3.0版本
V1.4.4
2020-06-04
穆某某
7.4聚合支付接口新增网联互联互通主扫，被扫子产品，7.29商户收款二维码查询接口新增字段type,增加网联互联互通静态码查询
文档概述
本文描述了天府支付针对合作服务商提供的聚合支付解决方案，帮助商户轻松实现聚合支付收款的功能。文档分别从交互模式、签名、接口、详细介绍了天府支付的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。
阅读对象
合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程
业务术语
术语
示例
说明
服务商号
***
天府支付服务商号，用户各种接口操作、记账等，由天府支付自动分配的数字
特约商户号
***
天府支付的特约商户号，用户各种接口操作、记账等，由天府支付自动分配的数字和服务商号相关联
密钥
f7d1bef35c740c4884ffc4b9a89ab91
天府支付与商户之间约定的32位字符串，算签名sign时使用
请忽使用以上 服务/特约商户号,联系联调人员,单独注册测试联调账号.
规范及定义
商户订单号
商户订单系统用商户网站唯一订单号标识每一笔支付单。
订单防重
接入天府支付的商户必须保证：商户订单号在商户系统必须唯一，在天府支付系统内，服务商号、商户订单号确定唯一一笔订单。
接口规范
通讯方式：
商户系统和支付系统之间通过https协议来进行通信，接口以URL的形式提供以post的请求方式处理，接口说明中描述了post的请求参数。
请求参数为JSON格式数据，返回数据也是JSON格式，整个交互流程中，此接口仅作为数据服务接口，不提供任何页面输出，在调用此接口时，仅支持POST请求方式，method=post context-type=application/json或者text/json;
以下公共请求字段，仅适用于非异步通知类接口描述
公共请求参数：
字段名
变量名
必填
类型
说明
协议参数
接口版本
service_version
是
String(8)
版本号：1.1
字符集
input_charset
是
String(8)
字符编码,取值：UTF-8
签名方式
sign_type
是
String(8)
签名类型，取值：MD5
签名
sign
是
String(32)
签名
公共响应参数：
字段名
变量名
必填
类型
说明
协议参数
接口名称
service
是
String
接口名称
接口版本
service_version
否
String(8)
版本号，默认为1.0
字符集
input_charset
否
String(8)
字符编码,取值：UTF-8
签名方式
sign_type
否
String(8)
签名类型，取值：MD5
签名
sign
是
String(32)
签名
应答流水号
returnSerNo
是
String
应答流水号
返回状态码
retcode
是
Int
返回状态码，0000表示成某某，其他未定义
返回信息
retMsg
否
String(64)
返回信息，如非空，为错误原因。
请求头需求
http请求头里面增加2参数 client=域名， serialno=订单号
签名机制
为了保证数据传输过程中的数据真实性和完整性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。签名有两个步骤，先按一定规则拼接要签名的原始串，再选择具体的算法和密钥计算出签名结果。失败的结果不签名。
签名原始串
无论是请求还是应答，无论是用get、post，签名原始串按以下方式组装成字符串：
1、除sign、sign_type字段外，所有参数按照字段名的ascii码从小到大排序后使用QueryString的格式（即key1=value1&key2=value2…）拼接而成，空值不传递，不参与签名组串。
2、所有参数是指通信过程中实际出现的所有非空参数，如果传递的参数不是接口中指定的，则会报错。
签名原始串中，字段名和字段值都采用原始值，不进行URL Encode。
2签名算法
目前暂只支持MD5签名
MD5 是一种摘要生成算法，通过在签名原始串后加上商户通信密钥的内容，进行MD5运算，形成的摘要字符串即为签名结果。
注意：签名时将字符串转化成字节流时指定的字符集input_charset一致（使用UTF-8），以下是签名步骤：
参数数组
string[] params={
“service=pay_service”,
“partner=***90”,
“return_url= http://doc.001pp.com/epay/return_url.jsp”,
“out_trade_no=***123”,
“subject=test”,
“body=aaaa“,
“total_fee=100”,
};
过滤去除空值，排序得到待签名字符串
out_trade_no=***123&partner=***90
&return_url= http://doc.001pp.com/epay/return_url.jsp
&service= pay_service &subject=test&total_fee=100
集合类参数
部分接口入参中带有集合类型的参数，参数为List 或 Map,处理方法如下：
入参集合 List ( jsonString ( 放入整体的集合中 ( 排序/去空/加密 ( jsonString
入参集合 Map ( jsonString ( 放入整体的集合中 ( 排序/去空/加密 ( jsonString
附 demo：
签名
签名时要把天府支付分配给商户的私钥（key）加入进行MD5签名；
例如：MD5（参数字符串 + “商户的私钥”）
通知机制
对后台通知交互模式，如果天府支付收到商户系统的应答不是success或超时，天府支付认为通知失败，天府支付会通过一定的策略（如1小时共8次）定期重新发起通知，提高通知的成某某率,但天府支付不保证通知最终能成某某。
由于存在重新发送后台通知的情况，因此同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
天府支付推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回success。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的业务数据混乱。
接口
提现-申请接口
接口描述
商户调用该接口可实现商户余额提现到商户结算账户；提现金额不能超过商户可用余额；特约商户号为空时，为服务商提现，特约商户号不为空时为特约商户提现；提现接口并非实时接口，提现处理时间在30秒以内，提现到账时间非实时到账，具体看结算银行，一般不超过2小时。
接口地址
测试环境：https://e.etest.tf.cn:4443/tianfupay/pay/withdraw
请求参数列表
字段名
变量名
必填
类型
说明
接口名称
service
是
String
接口名称（withdraw_service）
服务商号
partner
是
String(10)
服务商号,由天府支付统一分配的；
特约商户号
subpartner
否
String(10)
商户号，由天府支付统一分配的；
金额
transamount
是
Number(18,2)
提现金额
异步通知地址
notify_url
否
异步通知地址
备注
remark
否
String(128)
备注
应答参数列表
字段名
变量名
必填
类型
说明
服务商号
partner
是
String(10)
服务商号,由天府支付统一分配的；
特约商户号
subpartner
否
String(10)
商户号，由天府支付统一分配的；
金额
transamount
是
Number(18,2)
提现金额
平台订单号
transaction_id
否
String(32)
提现流水号，天府支付交易流水号
手续费
charge
否
String
单位：元
异步通知参数列表(POST + JSON)
字段名
变量名
必填
类型
说明
服务商号
partner
是
String(10)
服务商号,由天府支付统一分配的；
会员号
memberno
否
String(10)
商户号，由天府支付统一分配的；
金额
amount
是
String
提现金额
平台订单号
plat_trans_no
是
String(32)
提现流水号，天府支付交易流水号
提现状态
status
是
String
交易状态 0-待受理 1-处理中 2-成某某 5-失败
接口名称
service
是
String
withdraw_service
接口版本
service_version
是
String
1.0
字符集
input_charset
是
String
UTF-8
签名
sign
是
String
签名
签名类型
sign_type
是
String
MD5
应答流水号
returnSerno
是
String
应答流水号
提现-申请查询接口
接口描述
商户调用该接口可实现商户提现结果查询；请求参数包含提现流水号和支付流水号，提现查询时，两个参数至少传一个。
提现状态成某某，并不代表提现金额已到结算户，具体到账时间得看本行核心或央行或银某某等系统处理情况；
接口地址
测试地址：https://e.etest.tf.cn:4443/tianfupay/pay/withdrawquery
请求参数列表
字段名
变量名
必填
类型
说明
接口名称
service
是
String
接口名称（withdrawquery）
服务商号
partner
是
String(10)
服务商号,由天府支付统一分配的；
特约商户号
subpartner
否
String(10)
商户号，由天府支付统一分配的；
提现流水号
transaction_id
是
String(32)
提现流水号，天府支付生成唯一流水
应答参数列表
字段名
变量名
必填
类型
说明
服务商号
partner
是
String(10)
服务商号,由天府支付统一分配的；
特约商户号
subpartner
否
String(10)
商户号，由天府支付统一分配的；
金额
transamount
是
Number(18,2)
提现金额
提现流水号
transaction_id
是
String(32)
提现流水号
提现状态
transstate
是
String(1)
交易状态 0-待受理 1-处理中 2-成某某 5-失败
动态一码付接口
接口描述
此接口为动态一码付接口，根据金额生成二维码，用户可以通过天府银行手机银行、微信、支付宝扫码进行支付。
接口地址
测试环境：https://e.etest.tf.cn:4443/tianfupay/trans/DynamicPayPreCreate
请求参数列表
字段名
变量名
必填
类型
说明
协议参数
接口名称
service
是
String
接口名称 pay_service
接口版本
service_version
是
String(8)
版本号，默认为1.1
字符集
input_charset
是
String(8)
字符编码,取值：UTF-8。
签名方式
sign_type
是
String(8)
签名类型，取值：MD5
签名
sign
是
String(32)
签名
业务参数
服务商号
part 内容过长，仅展示头部和尾部部分文字预览，全文请查看图片预览。 码支付)
alipay_qr_a
直连模式
是
支付宝当面付 主扫(扫码支付)
alipay_qr_p
直连模式
是
微信公众号支付（一码付）
wx_pub
直连模式
是
微信扫码支付 主扫
wx_qr_p
直连模式
是
微信刷卡支付 被扫
wx_qr_a
直连模式
是
银某某云闪付-JS支付
unionpay_jspay
是
贷款额度支付
loan
是
互联互通主扫
nucc_qr_p
是
互联互通被扫
nucc_qr_a
是
微信小程序支付
wx_lite
是
业务异常描述
在交易中，业务异常code一般会在交易状态为处理中或失败的事情有值，详细解释与说明请参见下表：
业务异常编码
描述
特殊说明
PAY_USERPAYING
用户支付中，需要输入密码
在被扫支付交易中，可能会出现此编码，意味交易正在处理中，等待用户输入支付密码完成交易。在获得此编码之后，商户可调用天府支付查某某（7.6订单查询接口）接口进行查询最终订单的交易状态
[文章尾部最后500字内容到此结束,中间部分内容请查看底下的图片预览]请点击下方选择您需要的文档下载。
以上为《天府支付聚合支付开发指南1.5》的无排版文字预览，完整内容请下载
天府支付聚合支付开发指南1.5由用户“曾海燕h”分享发布，转载请注明出处