> ## 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.
# 授权报告
> 讲「每日授权报告这份文件」本身：它在资金生命周期中的位置、authType / transactionType / approveFlag 枚举、下载方式、> 分隔字段布局与样本解读。报告的统一获取机制见 对账概述，两份文件的字段集中手册见 报告字段说明。
## 授权报告
无论您是要复核每一次授权决策、核对哪些交易被批准或拒绝，还是满足监管对授权流程可追溯的要求，每日授权报告（Authorisation Report）都能提供当日完整、可存储的授权决策记录。DCS 作为持牌发卡机构，将每一笔授权决策（包括同意与拒绝）记录为标准化字段，并通过每日全量对账文件交付给接入机构。
授权报告记录的是**授权阶段的决策与额度占用**——即「这笔交易是否放行、冻结了多少」，而非资金最终落地结果。它与交易流水报告（Transaction Report）一同交付：授权报告回答「批没批」，交易流水报告回答「最终扣了多少」。
***
## 它在资金生命周期中的位置
在合作伙伴自管方案中，额度由接入机构掌握，授权由接入机构决策。DCS 将渠道的授权请求转发给接入机构判定放行与否，并把每一次决策结果落为授权记录。授权 → 待清算 → 交易流水三者通过 ID 串联：
* 授权报告中的每条记录通过 `authId` 唯一标识，通过 `outsId` 关联到对应账单（待清算）。
* `originalAuthId` 用于多笔退款、增量授权等需要追溯到原始授权的关联场景。
* 授权与清算的完整组合场景（普通清算、增量、撤销、超额/少额清算、强制清算、提现等），请参阅 [授权与清算全场景](../transactions/auth-and-settlement)。
***
## 授权类型（authType）
`authType` 标识一条授权记录的产生方式，帮助接入机构区分实时授权与系统补建、释放等不同场景。
| 枚举值 | 名称 | 说明 |
| --------------------- | ------ | --------------------------------------------------- |
| `NORMAL` | 普通授权 | 由渠道授权回调产生的实时授权记录，涵盖消费、增量、撤销、退款、提现、查询等场景 |
| `FORCE_AUTH` | 强制授权 | 系统自动补建的授权记录，出现在清算时无对应授权（如离线交易）、或清算金额与冻结金额不一致需补差额的场景 |
| `EXPIRED_RELEASE` | 到期释放 | 授权超时未完成结算时，渠道通过结算文件通知释放已冻结的资金 |
| `STATUS_DIFF_RELEASE` | 状态差异释放 | 渠道因超时拒绝了授权，但系统侧已批准，状态不一致时触发的对账修正 |
权威定义另见 [授权与清算全场景](../transactions/auth-and-settlement)。
***
## 交易类型（transactionType）
`transactionType` 标识持卡人发起授权时的交易性质，便于接入机构在对账环节快速识别交易场景。
| 枚举值 | 名称 | 说明 |
| --- | ------ | -------------- |
| `R` | 卡消费 | 所有的卡消费交易 |
| `C` | ATM 提现 | ATM 提现等现金预支交易 |
| `Q` | 查询 | 查询类交易，无资金变动 |
| `P` | 退货/退款 | 所有向卡入金的转账或退款交易 |
***
## 授权状态与拒绝原因（approveFlag / rejectReason）
| 字段 | 取值 | 说明 |
| -------------- | --------- | -------------------------------- |
| `approveFlag` | `A` | 同意（approve），本次授权被放行 |
| `approveFlag` | `D` | 拒绝（decline），本次授权未放行 |
| `rejectReason` | 仅 `D` 时存在 | 拒绝的具体缘由，取值为 `DAPI_*` 错误码，常见取值见下表 |
`rejectReason` 常见取值：
| 取值 | 触发场景 |
| --------------------------------------- | ------------------------------ |
| `DAPI_AUTH_ENTERPRISE_REJECT` | 接入机构在授权回调中明确拒绝 |
| `DAPI_AUTH_ENTERPRISE_TIMEOUT_REJECT` | 接入机构未在应答窗口内响应，DCS 默认拒绝 |
| `DAPI_AUTH_INTERNAL_REJECT` | DCS 内部拒绝（如验签失败、转发失败、返回结果非协议值等） |
| `DAPI_AUTH_INSUFFICIENT_FUNDS_REJECT` | 资金不足，冻结/解冻校验未通过 |
| `DAPI_CARD_STATUS_NOT_ACTIVATED` | 卡未激活 |
| `DAPI_CARD_CONSUME_FROZEN` | KYC 因子过期且企业启用消费限制 |
| `DAPI_CARD_VELOCITY_LIMIT_CHECK_REJECT` | 卡限额（velocity limit）校验拒绝 |
| `DAPI_SYSTEM_ERROR` | 其他系统处理异常 |
> 由于授权决策权在接入机构侧，`rejectReason` 既可能源自接入机构的业务判定，也可能源自 DCS/渠道侧的校验与对账修正（如超时）。各码的归类与处理见 [授权拒绝与错误码](../transactions/decline-codes)。
***
## 如何获取授权报告
合作伙伴自管方案中，授权记录**不提供实时单笔查询接口**，统一通过**每日全量对账文件**交付。DCS 每日为每个接入机构（Enterprise）生成一份当日全量的授权文件。
**接口（领取下载链接）**
```
GET /open-api/enterprise/v1/settlement-file-url
```
| 参数 | 类型 | 必填 | 说明 |
| ---------- | ------ | -- | ----------------------------------------------------- |
| `fileType` | String | 是 | 文件类型，授权文件传 `authorisation`（交易流水传 `transaction`），最大 20 |
| `fileDate` | String | 是 | 文件日期，格式 `yyyyMMdd`，如 `20251106`，最大 8 |
请注意 `fileType` 取值为英式拼写 `authorisation`（非 `authorization`），如实传入。
**响应**：在统一响应结构 `{ code, message, messageDetail, data }` 中，`data` 为字符串形式的文件**下载链接**（AWS S3 临时链接，有效期较短，请领取后尽快下载）。
```json theme={null}
{
"code": "...",
"message": "...",
"messageDetail": { },
"data": "https://....s3.amazonaws.com/....authorisation.....?X-Amz-..."
}
```
> **响应结构说明**：判断调用是否成功以 `code` 为准；`message` 为简要提示，`messageDetail` 为面向终端展示的结构化消息对象（含 `title`/`type`/`action`/`linkUrl` 等）。统一结构与判定规则详见 [API 参考总览](../../api-reference/index)。错误码请参阅 [授权拒绝与错误码](../transactions/decline-codes)。
> **谁做什么**
>
> * **DCS**：每日生成当日全量授权文件并存入 S3，按需签发临时下载链接。
> * **接入机构**：调用本接口领取链接 → 在有效期内下载文件 → 存储核对授权决策与本侧记录是否一致。
系统默认 T+1 生成前一日文件，任务完成后可下载。临时下载链接固定有效 120 秒；过期后可再次调用接口领取新链接。
下载链接的统一获取方式与每日对账机制，另见 [对账概述](./overview)。
***
## 授权报告文件字段
每行一条授权记录，字段以 `>` 分隔，顺序如下：
| 字段 | 描述 | 补充说明 |
| ---------------------------- | --------- | ---------------------------------------------------------------------------- |
| `authId` | 授权唯一标识 ID | 用于关联交易流水、账单等后续记录 |
| `direction` | 交易方向 | `OUTGOING`（出金）/ `INCOMING`（入金） |
| `authType` | 授权类型 | 对应上文 `authType` 枚举，详见 [授权与清算全场景](../transactions/auth-and-settlement) |
| `outsId` | 账单 ID | 关联对应的待清算（Outstanding）记录 |
| `originalAuthId` | 原始关联授权 ID | 用于多笔退款、增量授权等关联场景的追溯 |
| `enterpriseId` | 企业 ID | 标识发起授权的接入机构 |
| `customerId` | 用户 ID | 标识授权对应的持卡人 |
| `cardId` | 卡 ID | 关联发生交易的卡片 |
| `pan` | 卡号 | 仅展示前六位 + 后四位，保障信息安全 |
| `approveFlag` | 授权状态 | `A` 同意 / `D` 拒绝 |
| `rejectReason` | 拒绝原因 | 仅当 `approveFlag` 为 `D` 时存在 |
| `approveDate` | 处理时间 | 格式 `yyyy-MM-dd'T'HH:mm:ss+08:00`（UTC+8） |
| `currency` | 币种 | ISO 3 位货币代码（结算币种） |
| `amount` | 金额 | 授权涉及的资金数额（结算币种金额） |
| `acquirerCurrency` | 用户请求币种 | 与实际结算币种可能存在差异 |
| `acquirerAmount` | 用户请求金额 | 对应请求币种的资金数额 |
| `cardAcceptorIdentification` | 商户号 | 交易涉及的商户标识 |
| `cardAcceptorNameLocation` | 商户信息 | 包含商户名称与地址 |
| `transactionType` | 交易类型 | 对应上文 `transactionType` 枚举，详见 [授权与清算全场景](../transactions/auth-and-settlement) |
| `merchantType` | 商户类型 | 即 MCC，4 位数字 |
| `createTime` | 创建时间 | 授权记录生成时间，格式同 `approveDate` |
| `modifyTime` | 更新时间 | 授权记录最后修改时间，格式同上 |
| `merchantCountryCode` | 商户国家代码 | 3 位数字国家代码 |
**示例样本**
```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
```
> 上方样本演示了一笔被拒绝的授权：`approveFlag=D`、`rejectReason=DAPI_AUTH_ENTERPRISE_TIMEOUT_REJECT`（接入机构授权超时拒绝），交易类型 `R`（卡消费），结算币种 `702`（SGD），商户国家 `840`（美国）。
***
## 注意事项
### 字段扩展说明
授权文件后续可能会追加新字段，字段扩展遵循以下兼容性承诺：
1. **存量列下标保持稳定**：当前文档已定义的列，其下标、含义永不变更，不删除、不在中间插入新列；
2. **新字段仅在行尾追加**：每次追加会提前发布变更通知，接入机构可按需读取新增下标；暂不需要时忽略行尾新增列即可，不影响既有解析；
3. **所有列均占位**：任何列（包括空值列）都保留占位，单行的分隔符数量与列数恒定一致。
建议按列下标解析字段，并兼容行尾出现未知的追加列。
***
## 下一步
* 核对资金最终扣减结果：[交易流水报告](./transaction-report)
* 理解授权从冻结到清算的完整组合场景：[授权与清算全场景](../transactions/auth-and-settlement)
* 查阅授权枚举的权威定义：[授权与清算全场景](../transactions/auth-and-settlement)
* 了解每日对账文件的统一获取机制：[对账概述](./overview)