> ## 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.
# 交易生命周期 · 概述
> 说明 DeCard 托管模式下「授权（冻结）→ 清算（入账）」的交易主线；具体接口、字段和场景示例请参阅对应操作指南。
## 📄 正文
在 DeCard 托管模型下，每一笔卡上资金的流动都遵循同一条主线：**授权（冻结）→ 清算（入账）**。理解这条主线，您就能解释用户账户里任意一笔金额变动的来龙去脉，并据此搭建自己的对账逻辑。
与合作伙伴自管模式不同，DeCard 托管模式的**授权决策在 DCS 系统内部完成**：持卡人刷卡时，系统直接校验该用户的独立余额、卡状态与限额并做出批准/拒绝，无需把授权请求转发给接入机构、也不存在让接入机构逐笔返回结果的同步回调。授权结果与余额变动以 Webhook 形式**通知**给您，资金的占用与扣减都落在该用户的独立余额上。
## 两个阶段，一个桥梁
每个用户账户按币种分别记账，用 **可用余额（`free`）/ 冻结余额（`freeze`）/ 总额（`total`）** 三个数描述任意时刻的资金状态。一笔交易分两阶段改写这三个数，**Outstanding（未入账记录）** 作为桥梁贯穿其间。
| 阶段 | 对余额的影响 | 说明 |
| ---------- | ------------------------------ | ------------------------------------------------------------------------------ |
| **授权（冻结）** | `free` 移入 `freeze`，`total` 不变 | 系统在内部完成决策，批准则冻结对应金额。**资金被冻结但不离开账户**，不发生实际扣款 |
| **清算（入账）** | 释放 `freeze` 并按实际金额从 `total` 扣减 | 商户提交最终金额后，交易从**未入账（outstanding）推进到已入账（posted）**；该笔资金此前已冻结，清算扣减的是冻结额与总额，不再动可用余额 |
桥梁是 **Outstanding**：授权阶段产生一笔未入账记录占用冻结额，清算阶段把它推进到 posted 并释放冻结。逐笔交易明细通过 `postIndicator`（`1`-已入账 / `0`-未入账）标识入账状态；若手上只有交易 ID 不确定其类型，可用 `POST /card/v1/transaction/id/resolve` 解析（返回 `posted` 布尔字段）。
> **不变量**：一笔交易**完全清算后，授权阶段占用的冻结额会归零**——多余冻结（部分清算）自动回到可用余额。这是判断对账是否完成的依据：只要某笔交易仍未记账、冻结未释放，就说明该笔交易尚未结清。
## 授权类型概览（authType）
授权结果以 `CARD_TRANSACTION` Webhook 通知，`authType` 标识授权性质。DeCard 托管模式只使用以下三种：
| 枚举值 | 名称 | 对余额的语义 |
| ---------- | ---- | ------------------------------ |
| `EXPEND` | 消费 | 冻结对应金额（`free` ↓ / `freeze` ↑） |
| `REFUND` | 退货 | 退货入账（最终入账在清算时落到 `free`） |
| `REVERSAL` | 消费冲正 | 释放原消费冻结（`freeze` ↓ / `free` ↑） |
> 授权方向以 `direction`（`DEBIT` 扣款 / `CREDIT` 入账）表达；反向交易（撤销 / 冲正 / 退款）会返回 `originalExternalTranId` 关联原始交易。完整字段表与三类场景的逐步时序，见 [授权](../how-to-use/managing-transactions/authorizing-transactions)。
## 一条主线，多种清算形态
真实世界里授权与清算不总是一一对应：商户可能少结（去掉小费）、超额（含小费/附加费）、分多笔发货，也可能在没有前置授权时直接清算。所有这些都只是「授权 → 清算」主线在冻结额上的不同释放/入账组合。区别在于 **冻结额怎么释放、按多少金额入账**：
| 形态 | 触发 | 冻结额与入账怎么动 |
| ---- | ------------------- | ---------------------------- |
| 标准清算 | 按授权金额全额清算 | 释放全额冻结，按授权金额入账，流程完成 |
| 部分清算 | 实际结算 \< 授权（如去掉小费） | 释放**全额**冻结，仅按实际金额入账，多余回到可用余额 |
| 超额清算 | 实际结算 > 授权（餐饮/酒店含小费） | 经卡网络/MCC 规则校验后，释放原冻结、按实际金额入账 |
| 多笔清算 | 一次授权多次分批清算（电商分批发货） | 维持冻结直至全部清算完成，再统一释放并入账 |
| 强制清算 | 无前置授权直接清算（离线/机上场景） | 无冻结可释放，直接入账扣减可用余额 |
| 退款 | 负向交易贷记回账户（可不关联原交易） | 直接入账，增加可用余额 |
> 各类清算的时序图、字段定义与对账方法，见 [清算](../how-to-use/managing-transactions/settlement)。
## 余额如何记账，授权如何决策
本页只说明交易主线。授权与清算的操作细节分别见：
* **余额模型**（`free` / `freeze` / `total`、按用户按资产记账、托管策略）见 [账户与资产模型](./ledgering-system)。
* **授权决策**（系统内校验项、Webhook 通知字段、沙盒模拟）见 [授权](../how-to-use/managing-transactions/authorizing-transactions)。
* **清算入账**（五类清算与退款形态、账单查询、资产变动明细、ID 解析）见 [清算](../how-to-use/managing-transactions/settlement)。
## 下一步
* 想了解一笔授权如何在系统内冻结资金、收到哪些 Webhook，请看 [授权](../how-to-use/managing-transactions/authorizing-transactions)。
* 想了解资金如何实际入账、账单如何出账、如何查询清算结果，请看 [清算](../how-to-use/managing-transactions/settlement)。
* 想了解可用 / 冻结余额与托管策略的全貌，请看 [账户与资产模型](./ledgering-system)。