跳转到主要内容
PUT
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

所有字段均为可选;PUT 执行部分更新。

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS 接受一个名字中的所有词语均出现在另一个名字中。

可用选项:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
必填范围: x >= 1
timeout_outcome
enum<string>
可用选项:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

您 VASP 档案的合规联系人邮箱。只有在通过邮件发送的链接(POST /v3/travel-rule/settings/compliance-email/confirmation/)确认该地址后,Didit 网络才会列出您的档案;更改此地址需要重新确认。

is_discoverable
boolean

您的 VASP 资料是否可以在 Didit 网络中被列出:可被其他 Didit 客户在 GET /v3/travel-rule/vasps/ 中检索到,并可通过 INTERNAL 轨道触达。列出还需要拥有已上线应用、开启 Travel Rule、提供法定名称以及经过确认的合规邮箱;didit_network 会指出缺少哪些项。默认值为 true。

threshold_amount
string

十进制字符串,大于或等于零,以您应用的默认货币计。触发托管交换的最低转账金额。

ownership_validation_mode
enum<string>

请参阅同名的响应字段。

可用选项:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

十进制字符串,0 或更大。

data_sharing_fields
object

按实体类型合并:省略的实体类型将保留其当前选项。如果所选选项无法满足您所在 jurisdiction 制度(欧盟 TFR 或 FATF 第 16 号建议)的汇款人义务(包括空列表),将被拒绝并返回 400。

matching_rules
object

按主体类型以及其内部字段进行合并。若字段未被该主体类型进行比对(例如针对 company 的 date_of_birth),则会被拒绝并返回 400。

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

为 true 时,钱包所有权小组件提供屏幕截图上传作为所有权证明方式。默认为 true。

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

对交易对手 VASP 进行可选的制裁和负面新闻筛查,按企业 AML 筛查价格按次计费。开启后,Didit 会筛查出站交易所触达的交易对手(复用 30 天内的筛查结果),您也可以使用 POST /v3/travel-rule/vasps/{vasp_id}/screening/ 对其进行筛查。默认为 false:不进行任何筛查或计费。

sunrise_policy
enum<string>

HOLD、REJECT、PROCEED,或为空以遵循 timeout_outcome。参见同名的响应字段。

可用选项:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD、REJECT、PROCEED,或为空以遵循 timeout_outcome。参见同名的响应字段。

可用选项:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

已选择退出平台成员资格的网络。这不会停用您已关联的自有成员资格,也不会配置不可用的网络。

可用选项:
GTR,
TRUST,
VERIFYVASP,
SYGNA

响应

已更新设置和个人资料,结构与 GET 相同。

is_enabled
boolean

此应用上出向 travelRule 交易的托管 Travel Rule 协商流程是否处于活动状态。

jurisdiction
string

您的 VASP 运营管辖区代码。默认为 "EU"。Didit 会将其映射到标记在您 Travel Rule 交易上的规管机制 travel_rule_regime(例如 EU 或欧盟成员国代码将变为 eu),交易规则可据此进行匹配。一旦 Didit 网络列出您的资料,其他 Didit 客户将在 VASP 目录中将其视为您的管辖区。

Maximum string length: 8
name_matching_strictness
enum<string>

转账达到 COMPLETED 状态前,收款人姓名必须匹配的严格程度。CONTAINS 接受一个名称的所有词均出现在另一个名称中的情况。

可用选项:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

AWAITING_COUNTERPARTY 状态的转账在被定期清理程序过期前可保持未确认的小时数。默认为 48。

必填范围: x >= 1
timeout_outcome
enum<string>

转账过期时对底层交易的处理方式。默认值为 HOLD。当 sunrise_policy 和 non_responsive_policy 适用且已设置时,以它们为准。

可用选项:
HOLD,
REJECT,
PROCEED
threshold_amount
string

十进制字符串,以您应用的默认货币计。触发托管交换的最低转账金额;低于该金额的转账直接解析为 NOT_APPLICABLE。Didit 会比对换算为您默认货币后的交易金额,或您发送的 amount_in_default_currency;当无可用的换算金额时,该阈值不适用。默认为 "0.00"(欧盟 TFR 不适用最低金额限制)。

ownership_validation_mode
enum<string>

钱包所有权所需的证明力度。FULL 始终需要证明(签名消息、测试存款或经过审核的截图),绝不单凭终端用户的陈述。SIMPLIFIED 在低于 simplified_validation_threshold 时接受自主声明,高于该阈值时需要证明。AUTOMATED 允许地址簿和先前的证明自行响应,当 allow_self_declaration 为 true 时包含自主声明。默认值为 AUTOMATED。

可用选项:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

十进制字符串,默认为 "0.00"。在 SIMPLIFIED 模式下,低于此金额(以阈值货币计)的转账接受自主申报。未标明该货币金额的转账视为高于该金额。

data_sharing_fields
object

Didit 就您自己的用户按实体类型向交易对手 VASP 发送的字段。无论列表内容如何,始终会发送 name 和 wallet_address。您未选择过的实体类型将共享所有字段。空列表也是一种选择:仅共享姓名和钱包。

matching_rules
object

按实体类型,交易对手数据的各个字段与您持有的数据进行比对的严格程度。省略的字段将保留其默认值。NONE 跳过比对,STRICT 要求词语完全一致,CONTAINS 接受一个值的所有词均出现在另一个值中,DEFAULT 为标准子集匹配,FUZZY 接受相近的拼写(对于出生日期,允许日和月调换)。

您的 VASP 法定名称。将 is_enabled 设为 true 时必填(非空)。

lei
string

您的法人实体标识符(LEI),展示在 VASP 名录中。

compliance_email
string<email>

您 VASP 档案的合规联系人邮箱。只有在通过邮件发送的链接(POST /v3/travel-rule/settings/compliance-email/confirmation/)确认该地址后,Didit 网络才会列出您的档案;更改此地址需要重新确认。

is_discoverable
boolean

您的 VASP 资料是否可以在 Didit 网络中被列出:可被其他 Didit 客户在 GET /v3/travel-rule/vasps/ 中检索到,并可通过 INTERNAL 轨道触达。列出还需要拥有已上线应用、开启 Travel Rule、提供法定名称以及经过确认的合规邮箱;didit_network 会指出缺少哪些项。默认值为 true。

inbound_auto_accept
boolean

为 true 时,如果入账 TRP 问询的收款人钱包是地址簿中经过验证且姓名匹配的条目,则该问询会自动获批。为 false 时,该问询将在 ON_HOLD 中等待您通过所有权 endpoint 进行批准或拒绝。INTERNAL 轨道和充值后转账不受影响。默认为 true。

allow_self_declaration
boolean

为 true 时,钱包所有权小组件提供自我声明作为备用证明方式。默认为 true。

allow_screenshot_proof
boolean

为 true 时,钱包所有权小组件提供屏幕截图上传作为所有权证明方式。默认为 true。

auto_wallet_verification
boolean

为 true 时,提交需要终端用户提供钱包控制证明的出账 Travel Rule 转账会自动生成绑定到该交易的钱包所有权小组件会话,并将其放入交易的 action_required 块中。默认为 true。

vasp_attribution_enabled
boolean

为 true 时,任何无法由任何轨道路由的出账 Travel Rule 转账都将通过区块链分析进行归因:目标钱包将解析为其所属的 VASP,该实体将记录在转账和 VASP 目录中,并且轨道将使用归因名称重新运行一次。默认为 true。

counterparty_screening_enabled
boolean

对交易对手 VASP 进行可选的制裁和负面新闻筛查,按企业 AML 筛查价格按次计费。开启后,Didit 会筛查出站交易所触达的交易对手(复用 30 天内的筛查结果),您也可以使用 POST /v3/travel-rule/vasps/{vasp_id}/screening/ 对其进行筛查。默认为 false:不进行任何筛查或计费。

sunrise_policy
enum<string>

当交易对手是 sunrise_jurisdictions 中尚未强制实施 Travel Rule 的司法管辖区目录条目时,过期转账对其交易的处理方式:HOLD 将其移至审核,REJECT 将其拒绝,PROCEED 保持其状态不变。留空(默认值)则遵循 timeout_outcome。在 non_responsive_policy 之前生效。

可用选项:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

只读。Didit 视为处于 Travel Rule 日出期的国家/地区(ISO 3166 alpha-2),在此期间适用 sunrise_policy。目前包括 CO、KH 和 VN。任何其他司法管辖区,以及为空或未知的管辖区,均遵循 timeout_outcome。

non_responsive_policy
enum<string>

当交易对手是响应状态为 UNRESPONSIVE 的目录条目时,过期转账对其交易的处理方式:HOLD、REJECT 或 PROCEED(与 timeout_outcome 相同)。留空(默认值)则遵循 timeout_outcome。当两者均符合条件时,sunrise_policy 优先适用。

可用选项:
,
HOLD,
REJECT,
PROCEED
travel_address
string

只读。您所在 VASP 专属的 Travel Address,即其他 VASP 用于联系您的编码入站 TRP 查询 endpoint。当 is_enabled 为 false 时为空。

disabled_networks
enum<string>[]

已选择退出平台成员资格的网络。这不会停用您已关联的自有成员资格,也不会配置不可用的网络。

可用选项:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

按网络列出:此应用将如何发送以及为何无法发送。默认不包含任何网络(包括 GTR):网络可通过您自己已连接的成员资格访问,或者在 Didit 在该网络上的成员资格生效且您自己在该网络上的参与方处于活跃状态后,通过 Didit 的成员资格访问。非实时健康状态或投递检查。

didit_network
object
read-only

Didit 网络是否收录了您的 VASP 资料(以便其他 Didit 客户能在名录中找到并能通过 INTERNAL 轨道联系到它),以及其目前仍欠缺的各项条件。

最后修改于 2026年11月7日