Skip to main content
字段最丰富的来源是账单详情接口 GET /card/v2/statements/detail,本页以它为主表,辅以法币交易记录 GET /card/v1/fiat/transactions 的字段。各接口的查询方式、前置条件与分页规则见 交易管理 · 概述,本页不重复,只讲字段。
为什么不是「CSV 列字典」:DeCard 托管模式的数据通过实时查询接口返回 JSON,不提供每日全量对账文件。因此本页讲的是接口响应字段,而非文件列。如需每日对账文件,请与 DCS 团队确认。

前置条件

  • 您已开通企业(Enterprise)账户并持有 ApiKey / SecretKey,见 前置准备鉴权指南
  • 终端用户已持有 externalUserId(见 用户注册)且已开卡(持有 cardId,见 卡管理 · 申请卡)。
  • 本页所有示例中的 externalUserIdcardId、卡号、商户名、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 托管模式特有:每条卡交易都对应用户底层资产(稳定币)的变动明细,这是「加密货币 → 法币 → 卡消费」全流程可见性的一部分。

二 · 卡消费流水字段(辅助)

三 · 法币交易记录字段(辅助)

关键字段定义与本页一致:debitCreditIndcatorC/D)、transactionAmount(高精度小数,带 transactionCurrency)、postedTransactionIdmerchantName。交易类型字段为 postingTransType(如 CTU01 = 稳定币充值),枚举见 概述(第二节)
同名字段跨接口类型差异:本接口 GET /card/v1/fiat/transactionstransactionAmount字符串型金额,而账单详情 GET /card/v2/statements/detailtransactionAmountnumber。存储时请对法币流水的 transactionAmount 先按字符串解析再转高精度小数,勿假定为数值类型。

已入账与未入账

DeCard 托管模式没有每日报告文件,「这笔是否已最终结算」用 入账状态字段表达:
对账要点:以已入账(postIndicator = 1 / POSTED记录作为资金最终结算的权威依据;未入账记录是授权占用,金额可能随清算调整,不能直接当作扣款依据。授权与入账的概念主线见 交易生命周期 · 概述

报告数据说明

  • 数据载体:通过实时查询接口返回 JSON,不提供每日报告文件 / 对账 CSV 下载。
  • 金额单位:返回带币种的高精度小数,不做缩放。
  • 入账表达:以 postIndicator / POSTED 表达入账与否。
  • 特色字段assetMovements(底层稳定币资产变动)、postingAmountInSgd/Usd(双币种入账金额),以及法币流水的链上充值取证字段。

下一步