Skip to main content

📄 正文

在 DeCard 托管模型下,每一笔卡上资金的流动都遵循同一条主线:授权(冻结)→ 清算(入账)。理解这条主线,您就能解释用户账户里任意一笔金额变动的来龙去脉,并据此搭建自己的对账逻辑。 与合作伙伴自管模式不同,DeCard 托管模式的授权决策在 DCS 系统内部完成:持卡人刷卡时,系统直接校验该用户的独立余额、卡状态与限额并做出批准/拒绝,无需把授权请求转发给接入机构、也不存在让接入机构逐笔返回结果的同步回调。授权结果与余额变动以 Webhook 形式通知给您,资金的占用与扣减都落在该用户的独立余额上。

两个阶段,一个桥梁

每个用户账户按币种分别记账,用 可用余额(free)/ 冻结余额(freeze)/ 总额(total 三个数描述任意时刻的资金状态。一笔交易分两阶段改写这三个数,Outstanding(未入账记录) 作为桥梁贯穿其间。 桥梁是 Outstanding:授权阶段产生一笔未入账记录占用冻结额,清算阶段把它推进到 posted 并释放冻结。逐笔交易明细通过 postIndicator1-已入账 / 0-未入账)标识入账状态;若手上只有交易 ID 不确定其类型,可用 POST /card/v1/transaction/id/resolve 解析(返回 posted 布尔字段)。
交易生命周期:授权冻结到清算入账交易生命周期:授权冻结到清算入账
不变量:一笔交易完全清算后,授权阶段占用的冻结额会归零——多余冻结(部分清算)自动回到可用余额。这是判断对账是否完成的依据:只要某笔交易仍未记账、冻结未释放,就说明该笔交易尚未结清。

授权类型概览(authType)

授权结果以 CARD_TRANSACTION Webhook 通知,authType 标识授权性质。DeCard 托管模式只使用以下三种:
授权方向以 directionDEBIT 扣款 / CREDIT 入账)表达;反向交易(撤销 / 冲正 / 退款)会返回 originalExternalTranId 关联原始交易。完整字段表与三类场景的逐步时序,见 授权

一条主线,多种清算形态

真实世界里授权与清算不总是一一对应:商户可能少结(去掉小费)、超额(含小费/附加费)、分多笔发货,也可能在没有前置授权时直接清算。所有这些都只是「授权 → 清算」主线在冻结额上的不同释放/入账组合。区别在于 冻结额怎么释放、按多少金额入账
各类清算的时序图、字段定义与对账方法,见 清算

余额如何记账,授权如何决策

本页只说明交易主线。授权与清算的操作细节分别见:
  • 余额模型free / freeze / total、按用户按资产记账、托管策略)见 账户与资产模型
  • 授权决策(系统内校验项、Webhook 通知字段、沙盒模拟)见 授权
  • 清算入账(五类清算与退款形态、账单查询、资产变动明细、ID 解析)见 清算

下一步

  • 想了解一笔授权如何在系统内冻结资金、收到哪些 Webhook,请看 授权
  • 想了解资金如何实际入账、账单如何出账、如何查询清算结果,请看 清算
  • 想了解可用 / 冻结余额与托管策略的全貌,请看 账户与资产模型