5.1【应用集合对账文件下载】


测试地址: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文件)

业务响应参数

  1. 成功下载直接返回文件流;
  2. 失败的情况返回错误信息错误码,竖线分割。例如:0001|文件不存在

maxy2 2025年4月9日 16:16 收藏文档