测试地址:http://116.228.64.55:28082/yst-service-api/file/download
生产地址:https://ibsapi.allinpay.com/yst-service-api/file/download
接口代码(transCode):4002
功能说明:
- 接口用于平台从云商通系统获取对账文件,供平台进行对账,建议早上9:30后下载;
- 对账内容包含纳入订单类型=“消费、退款、银行子账户支付、银行子账户退款、银行子账户提现”,且“订单状态=交易成功”等订单;
- 对账文件名称:yyyy-mm-dd_应用编号_checkFile.txt
明细对账文件格式:通联订单号|订单类型|交易金额(单位:分)|平台抽佣金额(单位:分)|交易时间|商户订单号|原商户订单号|原通联订单号|支付模式|扩展参数|结算金额|预留字段1|预留字段2|预留字段3|渠道金额|渠道流水号|渠道手续费(单位:分)|渠道交易类型|卡号|卡类别|
- Excel对账单文件名称格式:yyyy-mm-dd_应用编号_checkFile.xlsx
- 通联订单号:通联生成唯一订单号。
- 订单类型:详见订单类型的枚举值。
- 交易金额:单位:分;
- 平台抽佣金额:单位:分,平台通过订单的 “couponAmount”字段向会员收取的抽佣金额,资金入平台簿记账户,如果为空,该字段默认显示为0,而不是空串;
- 交易时间:yyyyMMddHHmmss,订单支付完成时间;
- 商户订单号:商户通过订单上送的“商户订单号”;
- 原商户订单号:针对退款订单/提现退票订单,返回原商户订单号;单订单担保确认、单会员担保确认、批量分账的订单,返回原商户订单号;
- 原通联订单号:针对退款订单/提现退票订单,返回原通联订单号;单订单担保确认、单会员担保确认、批量分账的订单,返回原商户订单号;
- 支付模式:订单的支付模式,对应【支付模式】;
- 扩展参数:订单申请上送的“扩展参数-extendParams”信息,原样透传返回给商户;
- 结算金额:通过【消费申请】的交易,该笔交易的结算金额;
- 预留字段1:目前默认为空,以便后续扩展;
- 预留字段2:目前默认为空,以便后续扩展;
- 预留字段3:目前默认为空,以便后续扩展;
- 渠道金额:单位:分,从支付渠道对账文件获取的支付渠道金额,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
- 渠道流水号:从支付渠道对账文件获取的渠道流水号,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
- 渠道手续费:单位:分,从支付渠道对账文件获取的支付交易手续费,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
- 渠道交易类型:透传渠道实际交易类型,针对收银宝入金交易返回;
- 卡号:透传渠道返回的用户交易使用的卡号信息,其中银行卡返回卡号带掩码格式,微信支付返回用户openid,支付宝支付返回用户userid;
- 卡类别:透传渠道返回的用户交易使用的卡种;
- 银行类交易如下字段有值:
字段名称 |
通联订单号 |
订单类型 |
交易金额 |
交易时间 |
商户订单号 |
原商户订单号 |
原通联订单号 |
支付模式 |
扩展参数 |
5. 验签逻辑:
(1)请求:将spAppId,appId,fileType,fileDate四个字段的值依次拼接,组成待签名串,然后签名即可;
6. 请求方式:
(1)以form表单(Content-Type: application/x-www-form-urlencoded)形式提交请求
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
appId |
String |
|
是 |
应用号 |
|
spAppId |
String |
|
否 |
服务商应用号 |
|
fileDate |
String |
8 |
是 |
对账文件日期 |
YYYYMMDD |
fileType |
String |
2 |
是 |
文件类型 |
1:txt文件 2:excel文件 |
sign |
String |
是 |
签名 |
将spAppId+appId+fileType+fileDate值拼接后使用SM3withSM2进行签名后base64编码生成的字符串 |
|
fileDimension |
String |
|
否 |
文件维度 |
为空时为日对账单 orderDaily:日维度对账单 orderMonthly:月维度对账单(仅支持excel文件) |
业务响应参数
- 成功下载直接返回文件流;
- 失败的情况返回错误信息错误码,竖线分割。例如:0001|文件不存在