测试地址:http://116.228.64.55:28082/yst-service-api/file/download
生产地址:https://ibsapi.allinpay.com/yst-service-api/file/download
接口代码(transCode):4002
功能说明:
1. 接口用于平台从云商通系统获取对账文件,供平台进行对账,建议早上9:30后下载;
2. 对账内容包含所有成功订单;
3. 对账文件名称:yyyy-mm-dd_应用编号_checkFile.txt
明细对账文件格式:通联订单号|订单类型|交易金额(单位:分)|平台抽佣金额(单位:分)|交易时间|商户订单号|原商户订单号|原通联订单号|支付模式|扩展参数|结算金额|预留字段1|预留字段2|预留字段3|渠道金额|渠道流水号|渠道手续费(单位:分)|渠道交易类型|卡号|卡类别|渠道商户号|门店名称|终端号|
4. Excel对账单文件名称格式:yyyy-mm-dd_应用编号_checkFile.xlsx
(1) 通联订单号:通联生成唯一订单号。
(2) 订单类型:详见订单类型的枚举值。
(3) 交易金额:单位:分;
(4) 平台抽佣金额:单位:分,平台通过订单的 “couponAmount”字段向会员收取的抽佣金额,资金入平台簿记账户,如果为空,该字段默认显示为0,而不是空串;
(5) 交易时间:yyyyMMddHHmmss,订单支付完成时间;
(6) 商户订单号:商户通过订单上送的“商户订单号”;
(7) 原商户订单号:针对退款订单/提现退票订单,返回原商户订单号;单订单担保确认、单会员担保确认、批量分账的订单,返回原商户订单号;
(8) 原通联订单号:针对退款订单/提现退票订单,返回原通联订单号;单订单担保确认、单会员担保确认、批量分账的订单,返回原商户订单号;
(9) 支付模式:订单的支付模式,对应【支付模式】;
(10) 扩展参数:订单申请上送的“扩展参数-extendParams”信息,原样透传返回给商户;
(11) 结算金额:通过【消费申请】的交易,该笔交易的结算金额;
(12) 订单子类型
(13) 预留字段1:目前默认为空,以便后续扩展;
(14) 预留字段2:目前默认为空,以便后续扩展;
(15) 渠道金额:单位:分,从支付渠道对账文件获取的支付渠道金额,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
(16) 渠道流水号:从支付渠道对账文件获取的渠道流水号,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
(17) 渠道手续费:单位:分,从支付渠道对账文件获取的支付交易手续费,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
(18) 渠道交易类型:透传渠道实际交易类型,针对收银宝入金交易返回;
(19) 卡号:透传渠道返回的用户交易使用的卡号信息,其中银行卡返回卡号带掩码格式,微信支付返回用户openid,支付宝支付返回用户userid;
(20) 卡类别:透传渠道返回的用户交易使用的卡种;
(21) 渠道商户号:本交易在请求渠道流水中的渠道商户号,即实际交易的单商户/子商户;
(22) 门店名称:收银宝对账单中的“门店名称”;
(23) 终端号:收银宝对账单中的“终端号”。
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|文件不存在