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: ********************

Parámetros de ruta

Parámetros de Header

Respuestas

🟢200

application/json

Bodyapplication/json

🔴500

🟠409

🟠404

🟠400

🟠401

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>'

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

Linkear Cuenta Bancaria

Crear Persona