6. 应用集合对账文件下载


测试地址: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|渠道金额|渠道流水号|渠道手续费(单位:分)|渠道交易类型|卡号|卡类别|

  1. Excel对账单文件名称格式:yyyy-mm-dd_应用编号_checkFile.xlsx
  2. 通联订单号:通联生成唯一订单号。
  3. 订单类型:详见订单类型的枚举值。
  4. 交易金额:单位:分;
  5. 平台抽佣金额:单位:分,平台通过订单的 “couponAmount”字段向会员收取的抽佣金额,资金入平台簿记账户,如果为空,该字段默认显示为0,而不是空串;
  6. 交易时间:yyyyMMddHHmmss,订单支付完成时间;
  7. 商户订单号:商户通过订单上送的“商户订单号”;
  8. 原商户订单号:针对退款订单/提现退票订单,返回原商户订单号;单订单担保确认、单会员担保确认、批量分账的订单,返回原商户订单号;
  9. 原通联订单号:针对退款订单/提现退票订单,返回原通联订单号;单订单担保确认、单会员担保确认、批量分账的订单,返回原商户订单号;
  10. 支付模式:订单的支付模式,对应【支付模式】;
  11. 扩展参数:订单申请上送的“扩展参数-extendParams”信息,原样透传返回给商户;
  12. 结算金额:通过【消费申请】的交易,该笔交易的结算金额;
  13. 预留字段1:目前默认为空,以便后续扩展;
  14. 预留字段2:目前默认为空,以便后续扩展;
  15. 预留字段3:目前默认为空,以便后续扩展;
  16. 渠道金额:单位:分,从支付渠道对账文件获取的支付渠道金额,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
  17. 渠道流水号:从支付渠道对账文件获取的渠道流水号,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
  18. 渠道手续费:单位:分,从支付渠道对账文件获取的支付交易手续费,仅透传信息,如果为空,该字段默认显示为0,而不是空串。
  19. 渠道交易类型:透传渠道实际交易类型,针对收银宝入金交易返回;
  20. 卡号:透传渠道返回的用户交易使用的卡号信息,其中银行卡返回卡号带掩码格式,微信支付返回用户openid,支付宝支付返回用户userid;
  21. 卡类别:透传渠道返回的用户交易使用的卡种;
  22. 银行类交易如下字段有值:

字段名称

通联订单号

订单类型

交易金额

交易时间

商户订单号

原商户订单号

原通联订单号

支付模式

扩展参数

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:17 收藏文档