Saltar al contenido principal
POST
Crear cuenta (Banking Connectivity)
Crea una cuenta bancaria para una entidad con onboarding completado. El onboarding referenciado por onboarding_id debe tener status: SUCCEEDED. Un onboarding de tipo PREVIOUSLY_ONBOARDED no puede crear una cuenta hoy: la API responde 500 con PROVIDER_ACCOUNT_CREATION_FAILED. La respuesta incluye identificadores bancarios específicos de cada región. Consulta Identificadores de cuenta por región para saber qué campos se devuelven por región.

Autorizaciones

public-api-key
string
header
requerido
private-secret-key
string
header
requerido

Encabezados

x-idempotency-key
string
requerido

Identificador único que se usa en los encabezados HTTP para asegurar que una solicitud se procese una sola vez, aunque se reintente por problemas de red o tiempos de espera agotados. Consulta autenticación para ver los detalles (UUID).

Cuerpo

application/json
account_id
string
requerido

El identificador único de la cuenta de Yuno del comercio. Lo encuentras en el Dashboard de Yuno (UUID, 36 caracteres).

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

entity_id
string
requerido

El id de la entidad propietaria de la cuenta, que se obtiene de Create Entity (UUID, 36 caracteres).

Ejemplo:

"660e8400-e29b-41d4-a716-446655440000"

onboarding_id
string
requerido

El id de un onboarding exitoso, que se obtiene de Create Entity Onboarding (UUID, 36 caracteres). El onboarding debe tener status: SUCCEEDED.

Ejemplo:

"990e8400-e29b-41d4-a716-446655440000"

connection_id
string
requerido

El id de la conexión con el proveedor bancario en la que se abrirá la cuenta (UUID, 36 caracteres).

Ejemplo:

"bb0e8400-e29b-41d4-a716-446655440000"

account_type
enum<string>
requerido

El tipo de cuenta bancaria que se creará.

Opciones disponibles:
CHECKING,
SAVINGS,
INVESTMENT
Ejemplo:

"CHECKING"

currency
string
requerido

La moneda de la cuenta (ISO 4217, 3 caracteres). Los valores admitidos dependen de la región del proveedor: USD (EE. UU.), GBP (Reino Unido), AUD (Australia), EUR (UE).

Ejemplo:

"USD"

country
string
requerido

El país de la cuenta (ISO 3166-1 alpha-2, 2 caracteres).

Ejemplo:

"US"

Respuesta