Eliminar cuenta
DELETE /api/bank-accounts/{bank_account_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Elimina una cuenta sin movimientos.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Responde 409 cuando:
- la cuenta ya recibió o pagó dinero (desactívala con
status: 0); - es el destino por defecto de algún método de pago.
404 si no existe.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
bank_account_id |
ruta | sí | 1 |
Respuestas
200 — Eliminada
{
"success": true,
"data": {
"id": 3
},
"message": "Cuenta eliminada con éxito"
}
409 — Con pagos
{
"success": false,
"message": "La cuenta tiene pagos registrados, no se puede eliminar. Desactívala (status = 0) en su lugar."
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.