1. Cuentas
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • 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
      • Obtener jerarquía de persona
      • Bloquear persona y descendientes
      • Desbloquear persona y descendientes
      • Actualizar datos de persona
      • Eliminar persona (soft delete)
    • Transacciones
      • Crear Transacción
      • Create Notification
    • Operaciones
      • Listar Operaciones
    • Webhooks
      • Formato de Notificaciones Webhook
      • Crear Suscripción Webhook
      • Listar Suscripciones
      • Obtener Suscripción
      • Actualizar Suscripción
      • Eliminar Suscripción
  • Schemas
    • UnlinkAccountResponse
    • AccountListResponse
    • CreateSubscriptionRequest
    • UpdateAccountRequest
    • Person
    • LinkBankAccountRequest
    • PersonHierarchyResponse
    • HTTPValidationError
    • UpdateSubscriptionRequest
    • LinkBankAccountResponse
    • BlockPersonDataResponse
    • CreateTransactionRequest
    • CreateAccountRequest
    • AccountResponse
    • DeliveryInfo
    • BalanceResponse
    • TransactionDataResponse
    • AssetResponse
    • AuthResponse
    • CreatePersonRequest
    • PersonResponse
    • ErrorResponse
    • TransactionOperation
    • CreateWebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • WebhookEventType
    • SubscriptionResponse
    • UpdateWebhookSubscriptionRequest
    • LinkBankAccountDataResponse
    • CreateAssetRequest
    • SubscriptionListResponse
    • TransactionCreateResponse
    • AccountDetailResponse
    • WebhookSubscriptionListResponse
    • AssetListResponse
    • WebhookEventTypesResponse
    • LedgerResponse
    • WebhookEventsListResponse
    • PersonDataResponse
    • WebhookEventRecord
    • SimulateExternalTransferRequest
    • PersonListResponse
    • SimulateExternalTransferResponse
    • TransactionResponse
  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
JWT Bearer
Agregar el parámetro
Authorization
a Encabezados
Ejemplo:
Authorization: ********************
or
Parámetros de ruta

Parámetros de Header

Respuestas

🟢200
application/json
Bodyapplication/json

🔴500
🟠409
🟠404
🟠400
🟠401
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 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "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-05-08 15:28:29
Anterior
Linkear Cuenta Bancaria
Siguiente
Crear Persona
Built with