curl --request POST \
  --url https://api.qbank.cl/platform/v1/banking/virtual-ibans \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "purpose": "funding_usdt",
  "idempotency_key": "viban-funding-2026-001"
}
'

{
  "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.

POST

banking

virtual-ibans

curl --request POST \
  --url https://api.qbank.cl/platform/v1/banking/virtual-ibans \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "purpose": "funding_usdt",
  "idempotency_key": "viban-funding-2026-001"
}
'

{
  "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

Authorization

string

header

requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json

purpose

enum<string>

predeterminado:funding_usdt

Opciones disponibles:

funding_usdt,

banking_eur

idempotency_key

string

document_issued_country

string

País ISO alpha-2 de emisión del documento

documentIssuedCountry

string

Alias camelCase

document_expiration_date

string<date>

Vencimiento del documento; debe superar un mes desde hoy

documentExpirationDate

string<date>

Alias camelCase

incorporation_country

string

País ISO alpha-2 de incorporación

incorporationCountry

string

Alias camelCase

incorporation_date

string<date>

Fecha de incorporación

incorporationDate

string<date>

Alias camelCase

trading_website

string

Sitio web comercial de la empresa

tradingWebsite

string

Alias camelCase

business_activity

string

Actividad comercial de la empresa

businessActivity

string

Alias camelCase

is_micro_enterprise

string

Bandera microempresa '"true" o "false"'

isMicroEnterprise

string

Alias camelCase

expected_turnover

string

Facturación esperada opcional

expectedTurnover

string

Alias camelCase

tax_number

string

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)

taxNumber

string

Alias camelCase

address_zip

string

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)

addressZip

string

Alias camelCase

ubo_0_document_issued_country

string

País ISO alpha-2 de emisión del documento del UBO 0; repetir por índice de UBO'

ubo0DocumentIssuedCountry

string

Alias camelCase

ubo_0_document_expiration_date

string<date>

Vencimiento del documento del UBO 0; debe superar un mes desde hoy; repetir por índice de UBO'

ubo0DocumentExpirationDate

string<date>

Alias camelCase

ubo_0_pep

string

"true" o "false" si el UBO 0 es persona expuesta políticamente; repetir por índice de UBO

ubo0Pep

string

Alias camelCase

ubo_0_usa_tax_residency

string

"true" o "false" si el UBO 0 es residente fiscal EEUU; repetir por índice de UBO

ubo0UsaTaxResidency

string

Alias camelCase

ubo_0_first_name

string

Corrección del nombre del UBO 0 (pisa el valor KYB); repetir por índice de UBO

ubo0FirstName

string

Alias camelCase

ubo_0_last_name

string

Corrección del apellido del UBO 0 (pisa el valor KYB); repetir por índice de UBO

ubo0LastName

string

Alias camelCase

ubo_0_birth_date

string<date>

Corrección de la fecha de nacimiento del UBO 0 (pisa el valor KYB); debe dar edad 16–85; repetir por índice de UBO

ubo0BirthDate

string<date>

Alias camelCase

Respuesta

Replay idempotente de la misma solicitud.