Saltar al contenido principal
Cerrar la cuenta de un cliente en Midaz es un proceso de varios pasos que abarca tanto el Ledger (cuentas y saldos) como el CRM (titulares y cuentas alias). Como el cierre de cuentas es un evento regulado por las reglas del BACEN, el orden de las operaciones importa: debes detener los nuevos créditos, liquidar la actividad pendiente, devolver los fondos restantes y solo entonces desactivar los registros subyacentes. Esta guía recorre el flujo de cierre completo, desde la congelación del Titular hasta el archivado de sus Cuentas Alias. Puedes ejecutar el flujo de dos maneras: Vía API, con el endpoint, un payload de ejemplo y la justificación de cumplimiento de cada paso; o Vía Consola, con los pasos equivalentes de apuntar y hacer clic en la Consola de Midaz.
Sigue los pasos en orden. Cerrar cuentas o archivar registros del CRM antes de que los saldos estén en cero puede dejar fondos huérfanos o romper el rastro de auditoría requerido para los reportes regulatorios.

​
Resumen

El flujo de cierre tiene ocho pasos, agrupados en tres fases:
FasePasosObjetivo
1. Congelar1–2Detener los nuevos ingresos tanto a nivel de Titular como de Saldo.
2. Liquidar y poner en cero3–4Liquidar la actividad pendiente y devolver los fondos restantes al cliente.
3. Cerrar y archivar5–8Desactivar las Cuentas del Ledger y archivar los registros del CRM bajo la política de retención.
A lo largo de esta guía, {organization_id} y {ledger_id} identifican la Organización y el Ledger de Midaz que son dueños de las cuentas. Se abrevian como /v1/.../accounts/{accountId} para facilitar la lectura.

​
Requisitos previos

Antes de empezar, asegúrate de tener:
  • El holderId del cliente que se está dando de baja.
  • La lista de valores de accountId vinculados a ese Titular en el Ledger (obtenlos de las Cuentas Alias del Titular).
  • La confirmación de tu equipo de cumplimiento de que la relación con el cliente puede terminarse (sin bloqueos legales, disputas abiertas ni requisitos regulatorios pendientes).
  • Credenciales de API apropiadas con permiso para modificar titulares, saldos y cuentas.
El cierre de cuentas es irreversible desde la perspectiva del cliente. Confirma que no haya productos activos, transacciones programadas ni obligaciones abiertas antes de continuar.

​
Vía API

Ejecuta el flujo de cierre completo de forma programática. Cada paso indica el endpoint, un payload de ejemplo y la justificación de cumplimiento.

​
Paso 1 — Congela el Titular

Desactiva el Titular para que no se puedan iniciar nuevas cuentas alias ni flujos de trabajo posteriores del CRM para el cliente. Esta es la primera señal en toda la plataforma de que se está cerrando la relación. 
PUT /v1/holders/{holderId}

{
  "status": "INACTIVE"
}
Congelar el Titular es un cambio de estado lógico, no una eliminación. El registro permanece totalmente legible para fines de auditoría y regulatorios.

​
Paso 2 — Bloquea los créditos en las cuentas

Para cada cuenta vinculada al Titular, impide que entren nuevos fondos. Primero, lista los Saldos de la cuenta y luego actualiza cada saldo para deshabilitar la recepción. Obtén los saldos de la cuenta: 
GET /v1/.../accounts/{accountId}/balances
Para cada balanceId devuelto, bloquea los fondos entrantes: 
PATCH /v1/.../balances/{balanceId}

{
  "allowReceiving": false
}
Repite este paso para cada balanceId de cada cuenta que pertenezca al Titular. Un solo saldo que quede abierto aún puede recibir créditos y bloquear el cierre más adelante.
Establecer allowReceiving en false bloquea los nuevos ingresos pero sigue permitiendo las salidas — que es exactamente lo que necesitas para devolver el saldo restante al cliente en el Paso 4. Para más detalles sobre los flags de permiso, consulta Saldos.

​
Paso 3 — Liquida la actividad pendiente

Antes de poder poner un saldo en cero, la cuenta no debe tener movimientos en curso.
  • Verifica las transacciones en procesamiento. Confirma que no haya transacciones pendientes o sin confirmar en la cuenta. Confírmalas o cancélalas según corresponda usando Confirmar una transacción pendiente o Cancelar una transacción pendiente.
  • Cancela las programaciones activas. Cancela cualquier transacción recurrente o programada asociada a la cuenta para que no se generen nuevas entradas después de que comience el cierre.
Omitir este paso puede provocar que una cuenta cerrada reciba entradas tardías, lo que rompe la conciliación y el rastro de auditoría del BACEN.

​
Paso 4 — Pon el saldo en cero

Devuelve los fondos restantes al cliente (el titular de la cuenta) y confirma que cada saldo llegue a cero.
  • Registra una transacción de devolución que mueva el monto available restante de cada cuenta del cliente al destino designado del titular (por ejemplo, una cuenta de liquidación externa). Usa Crear una transacción.
  • Confirma que available = 0 en cada saldo de cada cuenta del Ledger antes de continuar. Puedes verificarlo con Obtener saldos por cuenta.
Midaz no permite eliminar una cuenta que aún tiene saldo. Todos los saldos deben estar en cero antes del Paso 5.

​
Paso 5 — Cierra las Cuentas del Ledger en Midaz

Con los saldos en cero y la actividad pendiente liquidada, elimina cada Cuenta del Ledger. 
DELETE /v1/.../accounts/{accountId}
Una solicitud exitosa devuelve 204 No Content. Repite para cada cuenta vinculada al Titular. Consulta Eliminar una cuenta para ver el contrato completo.
Eliminar una Cuenta del Ledger es una eliminación lógica. La cuenta y sus operaciones históricas permanecen disponibles para auditoría y reportes, sujeto a tu política de retención.

​
Paso 6 — Registra la fecha de cierre en el alias

Registra la fecha oficial de cierre en la Cuenta Alias del Titular para que el CRM y cualquier exportación regulatoria reflejen cuándo terminó la relación. 
PATCH /v1/holders/{holderId}/aliases/{aliasId}

{
  "bankingDetails": {
    "closingDate": "2026-06-09"
  }
}
closingDate reside en el objeto bankingDetails de la Cuenta Alias y usa el formato YYYY-MM-DD. Consulta Cuentas Alias para ver la referencia completa de campos. Establecer una fecha de cierre precisa es obligatorio para los reportes de ciclo de vida de cuentas del BACEN.

​
Paso 7 — Archiva las cuentas alias en el CRM

Archiva cada Cuenta Alias en el CRM. Usa una eliminación lógica (soft delete) para que el registro se retire del uso activo pero se conserve durante el período de retención regulatorio. 
DELETE /v1/holders/{holderId}/aliases/{aliasId}
No pases hard_delete=true. Un cierre regulado requiere que el registro se archive (eliminación lógica) y se conserve, no que se borre permanentemente. Consulta Eliminar una cuenta alias.

​
Paso 8 — Archiva el Titular en el CRM

Por último, archiva el propio Titular con una eliminación lógica una vez que se hayan archivado todas sus cuentas alias. 
DELETE /v1/holders/{holderId}
Como en el Paso 7, omite hard_delete=true. El registro del Titular debe conservarse bajo la política de retención aplicable para auditoría e inspección regulatoria. Consulta Eliminar un titular.

​
Vía Consola

Ejecuta el mismo flujo de cierre de ocho pasos desde la Consola de Midaz. La Consola cubre la mayor parte del flujo de forma point-and-click, pero dos pasos — bloquear créditos (Paso 2) y cancelar transacciones programadas (Paso 3) — todavía requieren la API. Cada paso a continuación indica el paso de API equivalente en esta página.
El orden es el mismo que el del flujo de API. No elimines cuentas ni archives registros del CRM antes de que los saldos estén en cero.

​
Paso 1 — Congela el Titular

Establece el Titular en INACTIVE para que no se puedan iniciar nuevas cuentas alias ni flujos de trabajo posteriores del CRM para el cliente.
1
En la página de Titulares, encuentra el Titular que estás dando de baja.
2
Haz clic en los tres puntos () en la columna Acciones y selecciona Editar.
3
En el formulario del Titular, establece el Estado en Inactivo.
4
Haz clic en Guardar.
Congelar el Titular es un cambio de estado lógico, no una eliminación. El registro permanece totalmente legible para fines de auditoría y regulatorios. Consulta Editar un Titular.

​
Paso 2 — Bloquea los créditos en las cuentas

Este paso requiere la API — la Consola no admite la edición de los flags de saldo después de la creación de la cuenta. La Consola solo permite establecer allowReceiving cuando se crea una Cuenta por primera vez, no al editar un saldo existente. Usa la API para deshabilitar la recepción en cada saldo.Sigue Paso 2 — Bloquea los créditos en las cuentas en la sección Vía API.
Para cada cuenta vinculada al Titular, establece allowReceiving en false en cada balanceId vía la API para que los nuevos ingresos queden bloqueados mientras las salidas siguen disponibles para la transacción de devolución del Paso 4.

​
Paso 3 — Liquida la actividad pendiente

Confirma que no haya movimientos en curso antes de poner cualquier saldo en cero.
1
En la página de Transacciones, filtra por las cuentas vinculadas al Titular y confirma que no haya transacciones pendientes o sin confirmar. Confirma o cancela las que estén en curso.
2
Cancela cualquier transacción recurrente o programada asociada a la cuenta para que no se generen nuevas entradas después de que comience el cierre.
Las transacciones programadas requieren la API. La Consola permite ver y cancelar transacciones individuales, pero no ofrece la gestión de transacciones programadas (recurrentes). Usa la API para cancelar las programaciones activas — consulta Paso 3 — Liquida la actividad pendiente en la sección Vía API.

​
Paso 4 — Pon el saldo en cero

Devuelve los fondos restantes al cliente y confirma que cada saldo llegue a cero.
1
En la página de Transacciones, haz clic en Nueva Transacción y crea una transacción de devolución que mueva el monto available restante de cada cuenta del cliente al destino designado del titular (por ejemplo, una cuenta de liquidación externa). Consulta Crear una Transacción.
2
Abre cada cuenta y confirma que el saldo available sea 0 antes de continuar.
Midaz no permite eliminar una cuenta que aún tiene saldo. Todos los saldos deben estar en cero antes del Paso 5.

​
Paso 5 — Cierra las Cuentas del Ledger en Midaz

Con los saldos en cero y la actividad pendiente liquidada, elimina cada Cuenta del Ledger.
1
En la página de Cuentas, encuentra la Cuenta vinculada al Titular, haz clic en los tres puntos () en la columna Acciones y selecciona Eliminar.
2
Aparecerá un cuadro de diálogo de confirmación. Haz clic en Confirmar para finalizar la eliminación.
3
Repite para cada cuenta vinculada al Titular.
Eliminar una Cuenta del Ledger es una eliminación lógica. La cuenta y sus operaciones históricas permanecen disponibles para auditoría y reportes, sujeto a tu política de retención. Consulta Eliminar una Cuenta.

​
Paso 6 — Registra la fecha de cierre en el alias

Registra la fecha oficial de cierre en la Cuenta Alias del Titular para que el CRM y las exportaciones regulatorias reflejen cuándo terminó la relación.
1
En la página de Cuentas Alias, encuentra la cuenta alias que vas a actualizar, haz clic en los tres puntos () en la columna Acciones y selecciona Editar.
2
En el formulario de la Cuenta Alias, establece la Fecha de Cierre (en bankingDetails) en la fecha oficial de cierre usando el formato YYYY-MM-DD.
3
Haz clic en Guardar.
Una fecha de cierre precisa es obligatoria para los reportes de ciclo de vida de cuentas del BACEN. Consulta Editar una Cuenta Alias.

​
Paso 7 — Archiva las cuentas alias en el CRM

Archiva cada Cuenta Alias con una eliminación lógica (soft delete) para que el registro se retire del uso activo pero se conserve durante el período de retención regulatorio.
1
En la página de Cuentas Alias, encuentra la cuenta alias que vas a archivar, haz clic en los tres puntos () en la columna Acciones y selecciona Eliminar.
2
Aparecerá un cuadro de diálogo de confirmación. Haz clic en Confirmar para finalizar.
Usa la eliminación estándar (lógica) para que el registro se archive y se conserve, no que se borre permanentemente. En despliegues regulados, el registro subyacente se conserva durante el período de retención. Consulta Eliminar una Cuenta Alias.

​
Paso 8 — Archiva el Titular en el CRM

Una vez que todas sus cuentas alias estén archivadas, archiva el propio Titular con una eliminación lógica (soft delete).
1
En la página de Titulares, encuentra el Titular que vas a archivar, haz clic en los tres puntos () en la columna Acciones y selecciona Eliminar.
2
Aparecerá un cuadro de diálogo de confirmación. Haz clic en Confirmar para finalizar.
Usa Eliminación Lógica (la opción por defecto), no Eliminación Definitiva. El registro del Titular debe conservarse bajo la política de retención aplicable para auditoría e inspección regulatoria. Consulta Eliminar un Titular.

​
Notas de cumplimiento del BACEN

  • El orden es obligatorio. Congelar los ingresos (Pasos 1–2) antes de liquidar y poner en cero (Pasos 3–4) evita que entren fondos a una cuenta que está en proceso de cierre.
  • Devuelve los fondos antes de cerrar. Cualquier saldo residual debe devolverse al cliente y confirmarse en cero antes de eliminar una cuenta. Cerrar una cuenta con fondos está bloqueado por Midaz y, además, no cumple con la normativa.
  • Archiva, no borres. Los titulares y las cuentas alias se eliminan lógicamente (sin hard_delete) para que los registros permanezcan disponibles durante el período de retención regulatorio. La eliminación definitiva eliminaría la evidencia requerida para las auditorías del BACEN.
  • Registra la fecha de cierre. El closingDate en el alias da a los reguladores una marca de tiempo autorizada de cuándo terminó la relación.
  • Conserva el rastro de auditoría. Las Cuentas del Ledger y las operaciones se eliminan lógicamente y permanecen consultables para conciliación y reportes.
Trata los ocho pasos como una sola transacción desde el punto de vista del cumplimiento: si algún paso falla, detente y resuélvelo antes de continuar, en lugar de dejar al cliente en un estado de cierre parcial.