> ## Documentation Index > Fetch the complete documentation index at: https://docs.thedecard.com/llms.txt > Use this file to discover all available pages before exploring further. # 交易报告 > 讲「交易流水报告这份文件」本身：生成规则、下载方式、> 分隔字段布局与样本解读。交易流水的概念与资金生命周期在 交易流水，本页不重复。 ## 每日交易流水报告 无论您是要逐日核对账户余额变动、还原每一笔实际资金变动，还是满足监管对资金流向可追溯、可审计的要求，每日交易流水报告都是可以直接使用的权威对账凭证。DCS 作为持牌发卡机构，每日将当日全部资金变动整理为标准化文件，存入 AWS S3，并通过统一接口交付给接入机构。 交易流水报告记录的是**资金的实际扣除与增加**（清算落地的结果），不包含授权阶段的冻结、解冻等中间状态。如需了解授权决策本身，请改用 [授权报告](./authorization-report)；两份文件配合即可还原从冻结到扣款的完整流程。 *** ## 生成规则 DCS 每日为每个接入机构（Enterprise）生成一份当日**全量**的交易流水文件。 | 项目 | 说明 | | ---- | -------------------------------------------- | | 生成范围 | 按 Enterprise 维度，每日一份全量文件 | | 存储位置 | AWS S3，通过 DCS 提供的接口签发临时下载链接 | | 文件格式 | 纯文本，每行一条流水，字段以 `>` 分隔（见下方「文件字段」） | | 触发时间 | 默认 T+1 生成前一日文件；具体运行时刻由任务平台配置，状态为 `DONE` 后可下载 | > **谁做什么** > > * **DCS**：每日生成全量交易流水文件并存入 S3，按需签发临时下载链接。 > * **接入机构**：调用下方接口领取链接 → 下载文件 → 存储核对账户余额变动与实际业务是否一致。 *** ## 如何获取文件 合作伙伴自管方案中，交易流水**不提供实时单笔查询接口**，统一通过每日全量文件交付。请用统一的结算文件下载接口领取链接： **`GET /open-api/enterprise/v1/settlement-file-url`** | 参数 | 位置 | 类型 | 必填 | 说明 | | ---------- | ----- | ------ | -- | ------------------------------------------------------ | | `fileType` | query | String | 是 | 文件类型，交易流水传 `transaction`（授权文件传 `authorisation`），max 20 | | `fileDate` | query | String | 是 | 文件日期，格式 `yyyyMMdd`，如 `20251106`，max 8 | **响应**：统一响应结构 `{ code, message, messageDetail, data }`，其中 `data` 为字符串形式的文件**下载链接**（S3 临时链接）。链接固定有效 120 秒，超时可重新领取。判断调用成败请以 `code` 为准，`messageDetail` 仅作前端展示、不用于判断成败；接口定义与响应字段见 [API 参考](../../api-reference/index)中的「企业账户与对账」组。 **请求示例** ``` GET /open-api/enterprise/v1/settlement-file-url?fileType=transaction&fileDate=20251106 ``` **响应示例** ```json theme={null} { "code": "SYS_SUCCESS", "message": "success", "messageDetail": null, "data": "https://.s3..amazonaws.com/...&X-Amz-Expires=120&..." } ``` 临时下载链接固定有效 120 秒。链接过期后，可凭同一 `fileType` + `fileDate` 重新调用本接口领取新链接。 *** ## 文件字段 每行一条交易流水，字段以 `>` 分隔，顺序如下： | 字段 | 描述 | 补充说明 | | ---------------------------- | --------- | -------------------------------------------------------------------------------------------------------------- | | `transactionId` | 交易流水唯一 ID | 标识每笔资金变动的唯一编号 | | `direction` | 交易方向 | `OUTGOING`（出金）/ `INCOMING`（入金） | | `outsId` | 账单 ID | 关联对应的待清算（Outstanding）记录 | | `authIds` | 关联的授权 ID | 多笔授权用英文逗号分隔，如 `1111,2222`；据此回链 [授权报告](./authorization-report) 中的 `authId` | | `enterpriseId` | 企业 ID | 标识资金变动对应的接入机构 | | `customerId` | 用户 ID | 标识交易对应的持卡人 | | `cardId` | 卡 ID | 关联发生交易的卡片 | | `pan` | 卡号 | 仅展示前六位 + 后四位，保障信息安全 | | `category` | 交易分类 | 对应交易分类 `code`，如 `RETAIL` 为普通消费，详见 [交易流水](../transactions/transaction) | | `currency` | 币种 | ISO 3 位货币代码 | | `amount` | 金额 | 交易涉及的资金数额（结算币种金额） | | `acquirerCurrency` | 用户请求币种 | 与实际结算币种可能存在差异 | | `acquirerAmount` | 用户请求金额 | 对应请求币种的资金数额 | | `cardAcceptorIdentification` | 商户号 | 交易涉及的商户标识 | | `cardAcceptorNameLocation` | 商户信息 | 包含商户名称与地址 | | `multiClearInd` | 清算标识 | `O` 普通单笔 / `P` 多笔清算非最后一笔 / `F` 多笔清算完成。判定一笔授权是否清算完结，请以收齐 `F` 为准，详见 [交易流水 · 多笔清算标识](../transactions/transaction) | | `merchantType` | 商户类型 | 即 MCC，4 位数字 | | `createTime` | 创建时间 | 交易记录生成时间，格式 `yyyy-MM-dd'T'HH:mm:ss+08:00`（UTC+8） | | `modifyTime` | 更新时间 | 交易记录最后修改时间，格式同上 | | `merchantCountryCode` | 商户国家代码 | 3 位数字国家代码 | | `originalTransactionId` | 原交易 ID | 退款类交易填被退款的原交易 `transactionId`，非退款交易该列为空 | > **时区注意**：报告内时间字段为 **UTC+8**（`+08:00`），与全站业务时间字段的 UTC+8 约定一致；例外是卡限额查询接口的日期字段为 UTC。 ### 示例样本 ```text theme={null} 174047198631807650000309>OUTGOING>1109862324019138561>1109862318201638913>1095041241881513984>1108391061086846977>1108449591919689729>4382140000003562>CASH>702>1.000000000000000000>>0E-18>001584054110002>>null>5399>2025-03-21T07:20:45+08:00>2025-03-21T07:20:45+08:00>840> 174047198631807650000310>OUTGOING>1109864282771689473>1109864282775883776>1095041241881513984>1108391061086846977>1108449591919689729>4382140000003562>CASH_FEES>702>1.000000000000000000>>0E-18>001584054110002>>null>5399>2025-03-21T07:24:25+08:00>2025-03-21T07:24:25+08:00>840> 174047198631807650000311>INCOMING>1109865120004237313>1109865120008431616>1095041241881513984>1108391061086846977>1108449591919689729>4382140000003562>PAYMENT>702>1.000000000000000000>>0E-18>001584054110002>>null>5399>2025-03-22T09:12:07+08:00>2025-03-22T09:12:07+08:00>840>174047198631807650000301 ``` > 前两行演示取现场景：第一行 `category=CASH` 为取现本金，第二行 `category=CASH_FEES` 为取现手续费，两条流水共享同一卡号、同一商户。第三行演示退款场景：`category=PAYMENT` 的入金流水，行尾 `originalTransactionId` 指向被退款的原消费流水的 `transactionId`；非退款交易该列为空，因此前两行以 `>` 结尾。空字段（连续 `>>`）表示该列无值。 对账文件中 `category` 存储为全称 `CASH` / `CASH_FEES`（取现本金 / 取现手续费），请以此为准。 *** ## 注意事项 ### 字段扩展说明 交易流水文件后续可能会追加新字段，字段扩展遵循以下兼容性承诺： 1. **存量列下标保持稳定**：当前文档已定义的列，其下标、含义永不变更，不删除、不在中间插入新列； 2. **新字段仅在行尾追加**：每次追加会提前发布变更通知，接入机构可按需读取新增下标；暂不需要时忽略行尾新增列即可，不影响既有解析； 3. **所有列均占位**：任何列（包括空值列）都保留占位，单行的分隔符数量与列数恒定一致。 建议按列下标解析字段，并兼容行尾出现未知的追加列。 *** ## 下一步 * 理解交易流水的概念与在资金生命周期中的位置：[交易流水](../transactions/transaction) * 核对授权决策侧的每日文件：[授权报告](./authorization-report) * 查阅交易分类（`category`）枚举的权威定义：[交易流水](../transactions/transaction) * 下载链接接口的完整定义与响应结构：见 [API 参考](../../api-reference/index)中的「企业账户与对账」组