n8n-nodes-gocardless-bad

Nodos personalizados para n8n que integran la Bank Account Data API (Open Banking) de GoCardless.

Estos nodos permiten trabajar con Institutions, Agreements, Requisitions y Accounts (incluye Transactions) de manera nativa en tus flujos de n8n.

Características

• Autenticación con secret_id y secret_key.
• Gestión automática de tokens: creación y refresco de access vía /api/v2/token/new/ y /api/v2/token/refresh/, con reintento ante 401.
• Recursos organizados al estilo de los nodos oficiales de n8n.
• Operaciones soportadas:
  • Institutions: list
  • Agreements: create, list, get, delete, accept, reconfirm (get/post)
  • Requisitions: create, list, get, delete
  • Accounts: get, balances, details, transactions
• Icono personalizado para el nodo.

Estructura del proyecto

n8n-nodes-gocardless-bad/
└── nodes/
    └── GoCardlessBAD/
        ├── GoCardlessBAD.node.ts          # Nodo principal
        ├── actions/
        │   ├── institutions/              # Institutions → list
        │   ├── agreements/                # Agreements → create, list, get, ...
        │   ├── requisitions/              # Requisitions → create, list, get, delete
        │   └── accounts/                  # Accounts → get, balances, details, transactions
        ├── methods/
        │   └── helpers.ts                 # apiRequest + manejo de tokens y refresh
        └── icons/
            └── GoCardLess.png             # Icono del nodo

Instalación

Desde npm (recomendado):

cd /home/node/.n8n/custom
npm install n8n-nodes-gocardless-bad
docker restart n8n

Configuración en n8n

1. En el editor de n8n ve a «Credenciales».
2. Crea credenciales «GoCardless BAD API» con:
   • Secret ID
   • Secret Key
3. Usa el nodo «GoCardless BAD» en tus flujos y elige:
   • Resource: Institutions / Agreements / Requisitions / Accounts
   • Operation: según el recurso (p. ej., list, get, balances, transactions)

Ejemplos rápidos

Listar instituciones en España

1. Añade un nodo «GoCardless BAD».
2. Selecciona:
   • Resource: Institutions
   • Operation: List
   • Country: ES
3. Ejecuta y verás el listado de bancos disponibles.

Crear una requisición

1. Añade un nodo «GoCardless BAD».
2. Selecciona:
   • Resource: Requisitions
   • Operation: Create
   • Institution ID: <id> (obtenido del nodo Institutions)
   • Redirect URL: https://tuapp.com/callback
3. Ejecuta para obtener el link de autorización del banco.

Obtener transacciones de una cuenta

1. Añade un nodo «GoCardless BAD».
2. Selecciona:
   • Resource: Accounts
   • Operation: Transactions
   • Account ID: <account_id>
3. Ejecuta para recibir el histórico de transacciones.

Desarrollo

# Instalar dependencias
npm install

# Compilar
npm run build

# Modo watch
npm run watch

# Linter
npm run lint

Roadmap

• [x] Institutions → List
• [x] Agreements → Create, List, Get, Delete, Accept, Reconfirm
• [x] Requisitions → Create, List, Get, Delete
• [x] Accounts → Get, Balances, Details, Transactions

Contribuir

¡Las PRs son bienvenidas! Si quieres añadir operaciones, mejorar documentación o tests, crea un PR o abre un issue.

Licencia

MIT © 2024 Tu Nombre

Disclaimer: Este proyecto no está afiliado oficialmente con GoCardless. Úsalo bajo tu propia responsabilidad, especialmente en entornos de producción.