{
"idempotency_hit": true,
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "DE890000000000000000",
"iban_country": "DE",
"status": "active"
}
}{
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"owner_account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"manager_account_id": "",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "",
"iban_country": "",
"status": "pending_approval",
"client_order": "platform:virtual-iban:org:account:funding_usdt:viban-funding-2026-001",
"order_reference": "",
"created_at": "2026-09-10T12:00:00Z",
"updated_at": "2026-09-10T12:00:00Z"
},
"status": "pending_approval"
}{
"error": "registrant_incomplete",
"message": "missing registrant fields: individual.document.issuedCountryCode, individual.document.expirationDate"
}申请 EUR 虚拟 IBAN
为已认证账户申请一个持久化的虚拟 IBAN。funding_usdt 是默认用途; banking_eur 要求启用银行服务。平台从已批准的 KYC/KYB profile 自动 补全 registrant V3。下列证件和公司注册字段可选,并接受 snake_case 与 camelCase aliases。企业账户还接受 trading_website、business_activity、 is_micro_enterprise、expected_turnover 以及每位 UBO 的证件对 (ubo_document_issued_country、ubodocument_expiration_date, UBO 索引从零开始,接受 camelCase aliases):企业通道要求每位 UBO 证件完整。UBO 身份更正(ubofirst_name、ubolast_name、 ubo_birth_date)可在不重新验证的情况下覆盖 KYB 错误数据;出生 日期(个人与 UBO)须使年龄为 16–85 岁。tax_number 适用于两个分支: 美国个人/企业须提供有效 9 位 SSN/EIN;其他国家校验已知格式 (智利 RUT、英国 NINO/UTR),无效值将被忽略而非报错。姓名将折叠为 通道拉丁字符集(José→Jose),地址按国家校验邮编格式, KYC 邮编有误时可用 address_zip 更正。已批准 KYB profile 中已有的值(注册信息、网站、行业、 UBO 证件)会自动补全—— overrides 仅补 profile 缺失项,显式 overrides 永远优先。 缺少必填路径时返回 422 registrant_incomplete,缺失路径位于 message。
{
"idempotency_hit": true,
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "DE890000000000000000",
"iban_country": "DE",
"status": "active"
}
}{
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"owner_account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"manager_account_id": "",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "",
"iban_country": "",
"status": "pending_approval",
"client_order": "platform:virtual-iban:org:account:funding_usdt:viban-funding-2026-001",
"order_reference": "",
"created_at": "2026-09-10T12:00:00Z",
"updated_at": "2026-09-10T12:00:00Z"
},
"status": "pending_approval"
}{
"error": "registrant_incomplete",
"message": "missing registrant fields: individual.document.issuedCountryCode, individual.document.expirationDate"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
funding_usdt, banking_eur 证件签发国家 ISO alpha-2 override
camelCase alias
证件到期日,必须晚于一个月
camelCase alias
公司注册国家 ISO alpha-2 override
camelCase alias
公司注册日期
camelCase alias
公司网站 override
camelCase alias
公司经营活动 override
camelCase alias
微型企业标志,"true" 或 "false"
camelCase alias
可选预期营业额
camelCase alias
个人与企业分支通用税号更正(美国个人:9 位 SSN/ITIN;美国企业:9 位 EIN;智利:带校验位的有效 RUT)
camelCase alias
KYC 邮编国家格式有误时的更正(空 = 使用 profile 值)
camelCase alias
UBO 0 证件签发国家 ISO alpha-2,按 UBO 索引重复
camelCase alias
UBO 0 证件到期日,必须晚于一个月,按 UBO 索引重复
camelCase alias
UBO 0 是否为政治公众人物,"true" 或 "false",按 UBO 索引重复
camelCase alias
UBO 0 是否为美国税务居民,"true" 或 "false",按 UBO 索引重复
camelCase alias
UBO 0 名字更正(覆盖 KYB 值),按 UBO 索引重复
camelCase alias
UBO 0 姓氏更正(覆盖 KYB 值),按 UBO 索引重复
camelCase alias
UBO 0 出生日期更正(覆盖 KYB 值),年龄须为 16–85 岁,按 UBO 索引重复
camelCase alias
响应
同一请求的幂等 replay。