对账概述

无论您是要做监管报送、数据仓库归档，还是要与自有账务系统逐笔对账，都可以通过 DCS 每日生成的全量报告文件，一次性拉取前一日的授权与交易明细。DCS 作为持牌发卡机构，会按合作配置定时生成标准化对账文件，并经接入机构鉴权后提供安全下载链接。报告是由平台数据生成的文件，用于汇总呈现某一主题的全量数据。对金融服务与账户类产品而言，报告对合规报送、风控决策与运营效率都至关重要——它提供的是某一时点的全量快照。如需实时变更，请使用 Webhook 通知，而非依赖报告文件。

两类每日报告

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

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

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

谁做什么

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

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

获取报告文件

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

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

请求参数

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

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

请求示例

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 白名单要求，请参考接入与鉴权。

响应示例

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

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

统一响应结构说明

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

成功时 code 的具体取值及完整错误码字典请参考授权拒绝与错误码，或联系 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；如需完整性校验，应在双方文件传输方案中另行约定

文件格式

报告为以 > 分隔的文本记录，每行一条，字段顺序与对应报告的「数据结构」表一致。授权报告示例（单行）：

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）。各字段含义见对应报告页与字段字典。

下一步

逐字段解析每日授权文件 → 每日授权报告
逐字段解析每日交易文件 → 每日交易流水报告
把两份文件串联对账 → 报告字段字典

​对账概述

​两类每日报告

​谁做什么

​获取报告文件

​请求参数

​请求示例

​响应示例

​统一响应结构说明

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

​文件格式

​下一步

对账概述

两类每日报告

谁做什么

获取报告文件

请求参数

请求示例

响应示例

统一响应结构说明

下载链接的时效（重要）

文件格式

下一步