跳转到主要内容
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
beneficiary_wallet_address
string
必填

目标钱包地址。Didit Test VASP 会向其发送资金,并根据资产所在链与您的钱包地址簿进行匹配。没有匹配条目的钱包也会被接受,入向交易将记为 ON_HOLD。

scenario
enum<string>
默认值:accept

Didit Test VASP 声明的收款人身份。accept 声明持有人本人的姓名;name_mismatch 声明任何持有人均不认可的姓名。决策本身始终由您做出。

可用选项:
accept,
name_mismatch
chain
string
默认值:ETH

资产所在的区块链网络。

amount
string
默认值:1

以十进制字符串表示的金额。

currency
string
默认值:ETH

资产代码。

reference
string

可选的幂等性密钥。使用相同值重试将返回首次调用所创建的转账。

响应

入账转账已记录并作出决策。使用相同的 reference 重复请求将返回相同的响应体。

transaction_id
string<uuid>

入账转账的 Didit 交易 UUID。

txn_id
string

Didit 生成的 txn_id。

scenario
string

运行的场景。

travel_rule_status
string

您的应用自身决策解析出的状态。

detail
string

转账最终判定为该状态的原因。

test_vasp
boolean

始终为 true:发送方为 Didit Test VASP。

travel_rule
object

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

最后修改于 2026年11月7日