跳转到主要内容
POST
curl

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

请求体

application/json
chain
string
必填

存款结算所在的区块链网络,例如 ETH。以小写形式存储,并与您的钱包地址簿条目进行不区分大小写的比对,因此请在地址簿中使用相同的区块链网络 token。

Maximum string length: 32
txid
string
必填

链上交易哈希。与 wallet_address 一起去重。

Maximum string length: 128
wallet_address
string
必填

您接收充值的目标钱包。XRP X-address 会被拆分为其传统地址和标签。

Maximum string length: 128
amount
string
必填

充值金额,采用十进制字符串表示,大于或等于零,最多保留 18 位小数。

currency
string
必填

充值资产,例如 "USDC"。

Maximum string length: 16
originator_data
object

来自发送方 VASP 的汇款人详情(如果已知),为扁平对象,例如 {"name": "..."}。Didit 会从中读取 name(或 full_name)、first_name、last_name 和 vendor_data。

beneficiary_data
object

收款人详情(您的客户),以扁平对象形式呈现,例如 {"name": "..."}。Didit 会将姓名与匹配的地址簿条目的 holder_name 进行比对,并根据请求设置 wallet_address 和 chain。

originating_vasp
object

发送方 VASP 的可选描述。它仅保留在此笔转账中(metadata.originating_vasp,以及 GET /v3/travel-rule/transfers/ 中该转账的汇款人 VASP);它绝不会创建、编辑或关联共享的 VASP 目录条目。

memo
string

可选。充值在支持 memo 的网络上的目标标签(destination tag)或 memo:在共享充值地址上,它用于区分您的不同客户,并将匹配该 memo 对应的地址簿条目。XRP:目标标签,为 0 到 4294967295 之间的整数(接受 JSON 数字)。XLM:最多 28 字节的文本 memo、64 位 ID 或 32 字节的十六进制哈希。EOS:最多 256 字节。ATOM:最多 256 个字符。HBAR:最多 100 字节。Bitcoin、EVM、Solana、Tron、Litecoin、Bitcoin Cash、Dogecoin 和 Lightning 钱包不接受 memo:若传入将返回 400。别名:destinationTag 或 destination_tag。

Maximum string length: 256
utxo
object

可选,仅限 UTXO 链。充值交易的输入和输出:发送方钱包为声明的 originator_data.wallet_address,否则取最大输入。

响应

针对该 txid 和 wallet_address 的转账已注册;原样返回现有记录(created 为 false)。

transaction_id
string<uuid>

入账存款的 Didit 交易 UUID。

txn_id
string

入账交易的 txn_id:当由 Didit 创建该交易时为 Didit 生成的 ID,或者当复用未认领的入账交易时为您自己的 ID。

created
boolean

当本次调用注册了该转账时为 true (HTTP 201);当相同 txid 和 wallet_address 的转账已存在时为 false (HTTP 200)。

travel_rule
object

所有权确认以及完成/取消 endpoint 返回的完整转账对象。当入站转账的钱包所有权未确认时,交易对手的 originator_data 和 beneficiary_data 会被掩码返回(保留每个单词的首字母;钱包、链以及 VASP 路由保持可读),且 data_masked 为 true。

最后修改于 2026年11月7日