Linkear Cuenta Bancaria

POST

/fidix/v1/accounts/link-bank-account

Linkea una cuenta virtual con una cuenta corriente del banco (CONSORCIO o INTERNACIONAL).
Bancos: CONSORCIO (alias 19 dígitos), INTERNACIONAL (alias 12 dígitos).

Solicitud

Autorización

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Linkeo creado exitosamente

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Linkeo exitoso con CONSORCIOLinkeo exitoso con INTERNACIONALLinkeo fallido con CONSORCIOLinkeo fallido con INTERNACIONAL

curl --location 'https://sandbox.fidi.money/fidix/v1/accounts/link-bank-account' \
--header 'idempotency-key;' \
--header 'x-api-key: {{apikey}}' \
--header 'x-api-key: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
    "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
    "bank_account_number": "1234567890",
    "bank_sponsor": "CONSORCIO",
    "tax_id_bank_account": "17876267-9"
}'

Ejemplo de Respuesta

201 - Éxito

{
    "data": {
        "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
        "bank_account_number": "1234567890",
        "bank_sponsor": "CONSORCIO",
        "virtual_account_alias": "9000000000000000001",
        "status": "ACTIVE",
        "created_at": "2026-05-22T13:8:34.144192Z",
        "activated_at": "2026-05-22T13:48:39.019737Z"
    }
}

Modificado en 2026-07-27 21:28:58

Obtener Cuentas linkeadas

Deslinkear Cuenta Bancaria