Saltar al contenido principal
PATCH
Actualizar cuenta (Banking Connectivity)
Actualiza una cuenta existente de Banking Connectivity. Incluye solo los campos que quieres cambiar.

Autorizaciones

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

Parámetros de ruta

account_id
string
requerido

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

Cuerpo

application/json

Todos los campos son opcionales. Envía solo los campos que quieras cambiar. La cuenta se identifica con el parámetro de ruta account_id, por lo que el cuerpo no lo repite.

account_type
enum<string>

El tipo de cuenta. No se puede cambiar: enviar un valor distinto del tipo almacenado devuelve 400 ACCOUNT_TYPE_CHANGE_NOT_ALLOWED.

Opciones disponibles:
CHECKING,
SAVINGS,
INVESTMENT
Ejemplo:

"CHECKING"

status
enum<string>

El estado de la cuenta. Los valores permitidos son ACTIVE, PENDING y FAILED. Establecer INACTIVE devuelve 400 ACCOUNT_STATUS_CHANGE_NOT_ALLOWED; usa Close Account en su lugar.

Opciones disponibles:
ACTIVE,
PENDING,
FAILED
Ejemplo:

"ACTIVE"

account_number
string

El número de cuenta.

Ejemplo:

"1234567890"

routing_number
string

El número de ruta (EE. UU.).

Ejemplo:

"123456789"

iban
string

El IBAN (UE).

Ejemplo:

"DE89370400440532013000"

balance
object

El saldo de la cuenta.

payment_rails
object

Los rieles de pago que admite la cuenta.

provider
object

Detalles de la cuenta del lado del proveedor.

Respuesta

OK

id
string

El identificador único de la cuenta de Banking Connectivity (UUID, 36 caracteres).

Ejemplo:

"aa0e8400-e29b-41d4-a716-446655440000"

entity_id
string

El id de la entidad asociada a esta cuenta.

Ejemplo:

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

onboarding_id
string

El id del onboarding usado para crear esta cuenta.

Ejemplo:

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

account_id
string

El identificador de la cuenta de Yuno del comercio.

Ejemplo:

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

provider
object
account_type
enum<string>
Opciones disponibles:
CHECKING,
SAVINGS,
INVESTMENT
Ejemplo:

"CHECKING"

status
enum<string>
Opciones disponibles:
ACTIVE,
PENDING,
INACTIVE
Ejemplo:

"ACTIVE"

account_number
string
Ejemplo:

"1234567890"

routing_number
string | null
Ejemplo:

"123456789"

iban
string | null
Ejemplo:

null

currency
string
Ejemplo:

"USD"

balance
object
account_details
object
payment_rails
object
supports_book_transfers
boolean
Ejemplo:

true

created_at
string
Ejemplo:

"2026-02-01T10:10:00Z"

updated_at
string
Ejemplo:

"2026-02-01T12:00:00Z"