> ## 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 每日生成的全量报告文件，一次性拉取前一日的授权与交易明细。DCS 作为持牌发卡机构，会按合作配置定时生成标准化对账文件，并经接入机构鉴权后提供安全下载链接。

报告是由平台数据生成的文件，用于汇总呈现某一主题的全量数据。对金融服务与账户类产品而言，报告对合规报送、风控决策与运营效率都至关重要——它提供的是某一时点的全量快照。如需实时变更，请使用 Webhook 通知，而非依赖报告文件。

***

## 两类每日报告

DCS 每天为每个接入机构（Enterprise）生成两份**全量**文件，分别覆盖授权与交易流水两个主题：

| 报告       | 文件类型（fileType）  | 一句话                           | 详情                               |
| -------- | --------------- | ----------------------------- | -------------------------------- |
| 每日授权报告   | `authorisation` | 当日全部授权决策记录（含同意/拒绝、拒绝原因、商户信息等） | [授权报告字段](./authorization-report) |
| 每日交易流水报告 | `transaction`   | 当日全部资金变动流水（清算、退款、消费等）         | [交易流水报告字段](./transaction-report) |

> **授权（Authorization）与交易（Transaction）的区别**：授权是刷卡瞬间的「决策与额度占用」记录；交易是实际「资金变动」流水。两者通过 `authId` / `authIds` 字段相互关联——一笔授权可能对应多笔清算交易。需要把两份文件串起来对账时，请参考[字段字典](./field-dictionary)。

### 谁做什么

| 环节                 | 谁做   |
| ------------------ | ---- |
| 定时生成全量文件、存入 AWS S3 | DCS  |
| 调用接口领取下载链接、下载并解析文件 | 接入机构 |
| 与自有账务系统逐笔核对        | 接入机构 |

> **生成/触发时间**：系统默认 T+1 生成前一日的两类文件；具体每日运行时刻由任务平台配置。任务状态为 `DONE` 后即可领取链接。

***

## 获取报告文件

文件存放在 DCS 的 AWS S3 存储桶中，不直接公开。您需要先调用结算文件接口换取一个**带时效的下载链接**，再用该链接下载文件。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/pa-report-fetch-light.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=d1c33fbc1d481cf950e491363bb4cf62" alt="对账文件的获取流程" width="512" height="338" data-path="imgs/diagrams/pa-report-fetch-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/pa-report-fetch-dark.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=8c2d60aefd1ec70140a15814c0fd0f0e" alt="对账文件的获取流程" width="512" height="338" data-path="imgs/diagrams/pa-report-fetch-dark.svg" />
</Frame>

**`GET /open-api/enterprise/v1/settlement-file-url`**

### 请求参数

| name       | in    | type   | required | 说明                                                           |
| ---------- | ----- | ------ | -------- | ------------------------------------------------------------ |
| `fileType` | query | string | ✓        | 文件类型，最大长度 20。取值：`authorisation`（授权文件）/ `transaction`（交易流水文件） |
| `fileDate` | query | string | ✓        | 文件日期，最大长度 8，格式 `yyyyMMdd`，示例 `20260126`                      |

<Warning>
  授权文件的 `fileType` 取值为 `authorisation`（英式拼写，带 `s`），并非 `authorization`。请按文档原样传入。
</Warning>

### 请求示例

```http theme={null}
GET /open-api/enterprise/v1/settlement-file-url?fileType=authorisation&fileDate=20260126
Host: <DCS API Host>
Content-Type: application/json
X-DAPI-API-KEY: <您的 api_key>
X-DAPI-TIMESTAMP: <请求时间戳，毫秒 UTC>
X-DAPI-NONCE: <10000-99999 随机数>
X-DAPI-SIGN: <按 HMAC-SHA256 计算的签名>
```

> 鉴权头的完整含义、签名计算与 IP 白名单要求，请参考 [接入与鉴权](../../integration-resources/authentication)。

### 响应示例

响应遵循统一响应结构。`data` 字段即为该文件的 S3 临时下载链接（字符串）。

```json theme={null}
{
  "code": "...",
  "message": "...",
  "messageDetail": {
    "message": "...",
    "title": "...",
    "type": "...",
    "icon": "...",
    "action": "...",
    "linkTitle": "...",
    "linkUrl": "..."
  },
  "data": "https://<s3-bucket>/...presigned-url..."
}
```

### 统一响应结构说明

| 字段              | 类型     | 说明                                                                           |
| --------------- | ------ | ---------------------------------------------------------------------------- |
| `code`          | string | 业务状态码。判断成功/失败请以 `code` 为准，错误码含义见 [授权拒绝与错误码](../transactions/decline-codes)   |
| `message`       | string | 概要信息                                                                         |
| `messageDetail` | object | 面向终端展示的结构化提示（title/message/icon/action/链接等），用于在前端引导用户；与业务成功与否无强绑定关系，请勿用它判断成败 |
| `data`          | string | 业务数据。本接口返回文件的临时下载链接                                                          |

> 成功时 `code` 的具体取值及完整错误码字典请参考 [授权拒绝与错误码](../transactions/decline-codes)，或联系 DCS 团队确认。

***

## 下载链接的时效（重要）

通过本接口返回的下载链接是一个 **S3 临时链接（Presigned URL），有效期固定 120 秒**。请在拿到链接后**立即下载**，不要把链接缓存下来供以后使用；过期后可重新调用接口领取新链接。

| 注意点   | 说明                                                                                                               |
| ----- | ---------------------------------------------------------------------------------------------------------------- |
| 有效期   | 固定 120 秒，过期后链接失效；底层文件保留，可重新领取链接                                                                                  |
| 过期怎么办 | 重新调用 `GET /open-api/enterprise/v1/settlement-file-url` 领取一个新链接即可（同一 `fileType`+`fileDate` 可重复领取）                 |
| 大文件   | 对接入机构始终交付一个文件，不会产生 `_part` 或分段序号文件                                                                               |
| 文件名   | 系统生成的随机名称（UUID 形式，如 `e53b723d-0b54-472f-89f9-587c7aedb07b.txt`），不携带企业或日期信息；请以请求时的 `fileType` + `fileDate` 自行归档命名 |
| 校验    | 当前不随附 checksum / MD5 / SHA；如需完整性校验，应在双方文件传输方案中另行约定                                                               |

***

## 文件格式

报告为以 `>` 分隔的文本记录，每行一条，字段顺序与对应报告的「数据结构」表一致。

授权报告示例（单行）：

```text theme={null}
1109086179954790401>OUTGOING>NORMAL>>>1095041241881513984>1108391061086846977>1108449591919689729>4382140000003562>D>DAPI_AUTH_ENTERPRISE_TIMEOUT_REJECT>2025-03-19T11:52:33+08:00>702>0.100000000000000000>>0E-18>>>R>5399>2025-03-19T03:52:31+08:00>2025-03-19T03:52:31+08:00>840
```

> 时间字段格式为 `yyyy-MM-dd'T'HH:mm:ss+08:00`（UTC+8）。各字段含义见对应报告页与 [字段字典](./field-dictionary)。

***

## 下一步

* 逐字段解析每日授权文件 → [每日授权报告](./authorization-report)
* 逐字段解析每日交易文件 → [每日交易流水报告](./transaction-report)
* 把两份文件串联对账 → [报告字段字典](./field-dictionary)