1. Cuentas
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • Conceptos Fundamentales
    • Catálogo de APIs
      • Diccionario de Datos - Enumeraciones
      • Autenticación
        • Obtener Token de Acceso
      • Cuentas
        • Crear Cuenta
          POST
        • Obtener Cuenta por ID
          GET
        • Listar Cuentas por Ledger
          GET
        • Actualizar Cuenta
          PUT
        • Eliminar Cuenta
          DELETE
        • Suspender Cuenta
          PATCH
        • Activar Cuenta
          PATCH
        • Obtener Balance de Cuenta
          GET
        • Obtener Cuentas linkeadas
          GET
        • Linkear Cuenta Bancaria
          POST
        • Deslinkear Cuenta Bancaria
          DELETE
      • Personas
        • Crear Persona
        • Listar Personas
        • Obtener Persona por ID
        • Actualizar datos de persona
        • Eliminar persona (soft delete)
        • Obtener jerarquía de persona
        • Bloquear persona y descendientes
        • Desbloquear persona y descendientes
      • Transacciones y Operaciones
        • Transacciones
          • Crear Transacción
        • Operations
          • Listar Operaciones
      • Webhooks
        • Crear Suscripción Webhook
        • Listar Suscripciones
        • Obtener Suscripción
        • Actualizar Suscripción
        • Eliminar Suscripción
      • Ledgers
        • Activar Ledger
        • Deshabilitar Ledger
  • Casos de Uso
    • Cuentas Virtuales
      • Guía de implementación
      • Create Notification
  • Raíz
  1. Cuentas

Deslinkear Cuenta Bancaria

DELETE
/fidix/v1/accounts/link-bank-account/{account_id}
Desactiva permanentemente un link de cuenta bancaria vinculada a una cuenta virtual.
Reglas de negocio:
Si ya existe un vínculo en estado INACTIVE para la cuenta → Error 409 (F006)
Si no existe ningún vínculo ACTIVE → Error 404 (F003)
Si el balance es mayor a 0 en cualquier dimensión → Error 400 (F001)

Solicitud

Autorización
or
Parámetros de ruta

Parámetros de Header

Respuestas

🟢200
application/json
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🟠409
🔴500
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://sandbox.fidi.money/fidix/v1/accounts/link-bank-account/fa83247a-248e-464d-ad46-e52d2f3a0081' \
--header 'traceparent: 00-a2ef46d2681a2dff0bc1784a065c69df-b87270a046308aa3-01' \
--header 'x-api-key: {{apikey}}' \
--header 'x-api-key: {{apikey}}'
Respuesta Ejemplo de Respuesta
200 - Éxito
{
    "data": {
        "account_id": "c0b5c0a6-a4a6-4cd9-8876-74dcf1c6839c",
        "bank_account_number": "123456789",
        "bank_sponsor": "BANKX",
        "virtual_account_alias": "901000000001",
        "status": "INACTIVE",
        "created_at": "2026-02-23T23:41:04.933271Z",
        "activated_at": "2026-02-23T23:41:18.469638Z",
        "deleted_at": "2026-02-23T23:42:42.192032Z"
    }
}
Modificado en 2026-07-27 21:29:02
Anterior
Linkear Cuenta Bancaria
Siguiente
Crear Persona
Built with