Skip to main content

每日交易流水报告

无论您是要逐日核对账户余额变动、还原每一笔实际资金变动,还是满足监管对资金流向可追溯、可审计的要求,每日交易流水报告都是可以直接使用的权威对账凭证。DCS 作为持牌发卡机构,每日将当日全部资金变动整理为标准化文件,存入 AWS S3,并通过统一接口交付给接入机构。 交易流水报告记录的是资金的实际扣除与增加(清算落地的结果),不包含授权阶段的冻结、解冻等中间状态。如需了解授权决策本身,请改用 授权报告;两份文件配合即可还原从冻结到扣款的完整流程。

生成规则

DCS 每日为每个接入机构(Enterprise)生成一份当日全量的交易流水文件。
谁做什么
  • DCS:每日生成全量交易流水文件并存入 S3,按需签发临时下载链接。
  • 接入机构:调用下方接口领取链接 → 下载文件 → 存储核对账户余额变动与实际业务是否一致。

如何获取文件

合作伙伴自管方案中,交易流水不提供实时单笔查询接口,统一通过每日全量文件交付。请用统一的结算文件下载接口领取链接: GET /open-api/enterprise/v1/settlement-file-url 响应:统一响应结构 { code, message, messageDetail, data },其中 data 为字符串形式的文件下载链接(S3 临时链接)。链接固定有效 120 秒,超时可重新领取。判断调用成败请以 code 为准,messageDetail 仅作前端展示、不用于判断成败;接口定义与响应字段见 API 参考中的「企业账户与对账」组。 请求示例
响应示例
临时下载链接固定有效 120 秒。链接过期后,可凭同一 fileType + fileDate 重新调用本接口领取新链接。

文件字段

每行一条交易流水,字段以 > 分隔,顺序如下:
时区注意:报告内时间字段为 UTC+8+08:00),与全站业务时间字段的 UTC+8 约定一致;例外是卡限额查询接口的日期字段为 UTC。

示例样本

前两行演示取现场景:第一行 category=CASH 为取现本金,第二行 category=CASH_FEES 为取现手续费,两条流水共享同一卡号、同一商户。第三行演示退款场景:category=PAYMENT 的入金流水,行尾 originalTransactionId 指向被退款的原消费流水的 transactionId;非退款交易该列为空,因此前两行以 > 结尾。空字段(连续 >>)表示该列无值。
对账文件中 category 存储为全称 CASH / CASH_FEES(取现本金 / 取现手续费),请以此为准。

注意事项

字段扩展说明

交易流水文件后续可能会追加新字段,字段扩展遵循以下兼容性承诺:
  1. 存量列下标保持稳定:当前文档已定义的列,其下标、含义永不变更,不删除、不在中间插入新列;
  2. 新字段仅在行尾追加:每次追加会提前发布变更通知,接入机构可按需读取新增下标;暂不需要时忽略行尾新增列即可,不影响既有解析;
  3. 所有列均占位:任何列(包括空值列)都保留占位,单行的分隔符数量与列数恒定一致。
建议按列下标解析字段,并兼容行尾出现未知的追加列。

下一步

  • 理解交易流水的概念与在资金生命周期中的位置:交易流水
  • 核对授权决策侧的每日文件:授权报告
  • 查阅交易分类(category)枚举的权威定义:交易流水
  • 下载链接接口的完整定义与响应结构:见 API 参考中的「企业账户与对账」组