加密货币充值（充值地址、链与币种）

​

概述

1. 调 GET /crypto/v2/deposit-address（推荐）获取该用户在指定链/币种的充值地址；链/币种不支持或未开启充值时取不到地址。
2. 用户向该地址转账 → 平台监测链上交易、达到确认数后入账 → 通过 Webhook 与 WebSocket 推送 ORDER_STATUS。

​

前置条件

​

关键概念

​

链上模式

​

充值地址

​

确认数

​

API 流程

​

接口详解

​

第 1 步：获取充值地址

fxRate（换汇汇率）用于展示折算金额，status 用于判断地址是否就绪。最小充值额与确认数不在本接口返回。链/币种不存在时 data 为空；链/币种未开启充值时返回错误码 NETWORK_COIN_CONFIG_NOT_SUPPORTED。

curl -X GET "https://api.thedecard-sandbox.com/crypto/v2/deposit-address?externalUserId=usr_xxx&network=TRON&coin=USDT" \
  -H "X-DAPI-API-KEY: <YOUR_API_KEY>" \
  -H "X-DAPI-TIMESTAMP: 1760943263227" \
  -H "X-DAPI-NONCE: 12345" \
  -H "X-DAPI-SIGN: <YOUR_SIGNATURE>"

{
  "code": "SYS_SUCCESS",
  "message": "",
  "messageDetail": null,
  "data": {
    "network": "TRON",
    "address": "T...占位地址，请勿照抄...",
    "fxRate": 1.0,
    "coin": "USDT",
    "status": "SUCCESS"
  }
}

响应结构全站统一为 { code, message, messageDetail, data }（无 success 布尔）；messageDetail 通常为 null，需要时为对象 {message, title, type, icon, action, linkTitle, linkUrl}。成功码 code 字面量为 SYS_SUCCESS（两种模式一致）。

​

资金到账后会发生什么

1. 用户转账：用户向充值地址转入对应链/币种的加密货币，链上产生交易哈希 txHash。
2. 平台监测：DCS 监测区块链网络，等待交易达到该链要求的确认数。
3. 入账：达到确认数后，资金计入用户在 DCS 的账户余额（独立账户 availableBalance）。
4. 状态推送：DCS 通过 Webhook 与 WebSocket 实时推送 ORDER_STATUS 订单状态变动通知（参见 接入资源 · WebSocket 实时推送）。
5. 机构查询：接入机构可随时调 GET /card/v1/fiat/transactions?externalUserId=... 查询充值/法币流水记录核对入账。

实时推送是「主动到账通知」；fiat/transactions 是「按需对账查询」。建议两者结合：以 WebSocket 触发 UI 更新，以 fiat/transactions 做最终对账。

​

支持的链 / 币种矩阵

​

沙盒模拟充值

POST /simulation/v2/deposit

{
  "chain": "",
  "currency": "",
  "amount": 100.0,
  "address": ""
}

填入时 address 用第 2 步获取的充值地址；chain / currency 目前只支持 TRON + USDT 与 Ethereum + USDC 两组。 模拟充值仅沙盒可用，用于触发到账与 ORDER_STATUS 推送（Webhook 与 WebSocket）以验证您的对接；接口返回本次模拟的 txHash。模拟接口与其它沙盒能力的整体说明见 模拟交易。

​

错误处理

完整错误码字典请向 DCS 团队索取；具体错误以接口返回的 code/message 为准。

​

下一步

• 实时到账通知见 接入资源 · WebSocket 实时推送