{
"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"
}Solicitar un IBAN virtual EUR
Solicita una asignación durable de IBAN virtual para la cuenta autenticada. funding_usdt es el propósito por defecto; banking_eur exige el producto Banca. La plataforma completa el registrant V3 desde el perfil KYC/KYB aprobado. Los campos opcionales de documento e incorporación aceptan aliases snake_case y camelCase. Las cuentas empresa también aceptan trading_website, business_activity, is_micro_enterprise, expected_turnover y un par documental por UBO (ubo_document_issued_country, ubodocument_expiration_date, índice de UBO base cero, aliases camelCase aceptados): el riel corporativo exige un documento completo por UBO. Las correcciones de identidad del UBO (ubofirst_name, ubolast_name, ubo_birth_date) pisan un KYB con datos erróneos sin re-verificar; las fechas de nacimiento (persona y UBOs) deben dar edad 16–85. tax_number funciona en AMBAS ramas: una persona/empresa US debe dar un SSN/EIN válido de 9 dígitos; otros países validan formatos conocidos (RUT CL, NINO/UTR GB) y omiten valores inválidos en vez de fallar. Los nombres se pliegan al charset latino del riel (José→Jose) y las direcciones validan el zip por país, con address_zip como corrección cuando el zip del KYC viene malo. Los valores ya presentes en el perfil KYB aprobado (incorporación, sitio web, industria, documentos UBO) se autocompletan — los overrides solo cubren lo que el perfil no trae, y el override explícito siempre gana. Si faltan rutas requeridas responde 422 registrant_incomplete y lista las rutas faltantes en 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"
}Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Cuerpo
funding_usdt, banking_eur País ISO alpha-2 de emisión del documento
Alias camelCase
Vencimiento del documento; debe superar un mes desde hoy
Alias camelCase
País ISO alpha-2 de incorporación
Alias camelCase
Fecha de incorporación
Alias camelCase
Sitio web comercial de la empresa
Alias camelCase
Actividad comercial de la empresa
Alias camelCase
Bandera microempresa '"true" o "false"'
Alias camelCase
Facturación esperada opcional
Alias camelCase
Corrección del número tributario en AMBAS ramas (persona: SSN/ITIN de 9 dígitos si US; empresa: EIN de 9 dígitos si US, RUT CL válido con dígito verificador)
Alias camelCase
Corrección del código postal cuando el KYC trae uno con formato inválido para su país (vacío = se usa el del perfil)
Alias camelCase
País ISO alpha-2 de emisión del documento del UBO 0; repetir por índice de UBO'
Alias camelCase
Vencimiento del documento del UBO 0; debe superar un mes desde hoy; repetir por índice de UBO'
Alias camelCase
"true" o "false" si el UBO 0 es persona expuesta políticamente; repetir por índice de UBO
Alias camelCase
"true" o "false" si el UBO 0 es residente fiscal EEUU; repetir por índice de UBO
Alias camelCase
Corrección del nombre del UBO 0 (pisa el valor KYB); repetir por índice de UBO
Alias camelCase
Corrección del apellido del UBO 0 (pisa el valor KYB); repetir por índice de UBO
Alias camelCase
Corrección de la fecha de nacimiento del UBO 0 (pisa el valor KYB); debe dar edad 16–85; repetir por índice de UBO
Alias camelCase
Respuesta
Replay idempotente de la misma solicitud.