字段最丰富的来源是账单详情接口 GET /card/v2/statements/detail,本页以它为主表,辅以法币交易记录 GET /card/v1/fiat/transactions 的字段。各接口的查询方式、前置条件与分页规则见 交易管理 · 概述,本页不重复,只讲字段。
为什么不是「CSV 列字典」:DeCard 托管模式的数据通过实时查询接口返回 JSON,不提供每日全量对账文件。因此本页讲的是接口响应字段,而非文件列。如需每日对账文件,请与 DCS 团队确认。
前置条件
- 您已开通企业(Enterprise)账户并持有
ApiKey / SecretKey,见 前置准备 与 鉴权指南。
- 终端用户已持有
externalUserId(见 用户注册)且已开卡(持有 cardId,见 卡管理 · 申请卡)。
- 本页所有示例中的
externalUserId、cardId、卡号、商户名、postedTransactionId 等均为占位 / 脱敏值,请勿在请求或日志中写入任何真实终端用户 PII。
字段定义(全站统一)
存储前请先了解以下 DeCard 托管模式字段定义:
DeCard 托管模式的字段集以本页各表为准;authorizationAmount / settlementAmount / interchangeAmount(×10^6) / cardLast4 / isThreeDSecureTransaction / walletName / foreignExchangeFees 等列在 DeCard 托管模式中不存在,请勿据此存储。
一 · 账单详情字段字典(主表)
脱敏响应样例(data 为账单内逐条明细的数组):
运行时成功码 code 的字面量为 SYS_SUCCESS(两种模式一致)。请以本页示例的运行时期望值判断成功 / 失败。
交易类型(transactionType)
transactionType 取自卡交易类型枚举 CardTransactionTypeEnum,已知取值为:
上表为 CardTransactionTypeEnum 在交易流水接口已确认的取值;如账单详情返回超出上表的值,以 DCS 实际返回为准,可联系 DCS 团队索取完整枚举字典。
资产变动(assetMovements[])
DeCard 托管模式特有:每条卡交易都对应用户底层资产(稳定币)的变动明细,这是「加密货币 → 法币 → 卡消费」全流程可见性的一部分。
二 · 卡消费流水字段(辅助)
三 · 法币交易记录字段(辅助)
关键字段定义与本页一致:debitCreditIndcator(C/D)、transactionAmount(高精度小数,带 transactionCurrency)、postedTransactionId、merchantName。交易类型字段为 postingTransType(如 CTU01 = 稳定币充值),枚举见 概述(第二节)。
同名字段跨接口类型差异:本接口 GET /card/v1/fiat/transactions 的 transactionAmount 为字符串型金额,而账单详情 GET /card/v2/statements/detail 的 transactionAmount 为 number。存储时请对法币流水的 transactionAmount 先按字符串解析再转高精度小数,勿假定为数值类型。
已入账与未入账
DeCard 托管模式没有每日报告文件,「这笔是否已最终结算」用 入账状态字段表达:
对账要点:以已入账(postIndicator = 1 / POSTED)记录作为资金最终结算的权威依据;未入账记录是授权占用,金额可能随清算调整,不能直接当作扣款依据。授权与入账的概念主线见 交易生命周期 · 概述。
报告数据说明
- 数据载体:通过实时查询接口返回 JSON,不提供每日报告文件 / 对账 CSV 下载。
- 金额单位:返回带币种的高精度小数,不做缩放。
- 入账表达:以
postIndicator / POSTED 表达入账与否。
- 特色字段:
assetMovements(底层稳定币资产变动)、postingAmountInSgd/Usd(双币种入账金额),以及法币流水的链上充值取证字段。
下一步