n8n-nodes-ibanforge 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IBANforge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # n8n-nodes-ibanforge
 
-IBAN validation, BIC/SWIFT lookup, Swiss clearing and compliance pre-checks inside your [n8n](https://n8n.io) workflows — backed by the [IBANforge](https://ibanforge.com?src=n8n) API and its 6 national bank registers (121k+ BIC entries, 89 IBAN countries).
+IBAN validation, BIC/SWIFT lookup, Swiss clearing and compliance pre-checks inside your [n8n](https://n8n.io) workflows, backed by the [IBANforge](https://ibanforge.com?src=n8n) API and national bank registers (121k+ BIC entries, 89 IBAN countries).
 
 Typical uses: verify supplier IBANs at onboarding, triage a payout list before the batch leaves, enrich a CRM record with the issuing bank, stop payments whose bank code the national register does not know.
 
@@ -11,7 +11,11 @@ Typical uses: verify supplier IBANs at onboarding, triage a payout list before t
 | **Validate IBAN** | Structure + checksum + issuing bank (BIC), bank-code check against the national register (`not_in_register` means the register allocates the code to nobody), EMI/vIBAN classification, SEPA + VoP reachability |
 | **Look up BIC** | BIC/SWIFT → bank name, city, country, LEI |
 | **Look up Swiss clearing** | BC-Nummer / IID → institution, seat address, SIC/euroSIC/instant rails, QR-IID semantics |
-| **Compliance check** | Bank-level sanctions (OFAC + EU), FATF lists, SEPA/VoP, 0-100 risk score. Bank-level, not name screening |
+| **Compliance check** | Bank-level sanctions (OFAC, EU, UN), FATF lists, SEPA/VoP, 0-100 risk score. Bank-level, not name screening |
+
+## Example workflow
+
+[`examples/check-supplier-iban.json`](https://github.com/cammac-creator/ibanforge/blob/main/integrations/n8n/examples/check-supplier-iban.json) is a four-node workflow you can paste into n8n (**Workflows → Import from File**, or paste it on the canvas): a manual trigger, a field holding a supplier IBAN, the IBANforge node set to **Validate IBAN**, and an **If** node that routes on the `valid` field of the answer. Pick your IBANforge API credentials on the IBANforge node after importing.
 
 ## Installation
 
@@ -25,7 +29,19 @@ npm install n8n-nodes-ibanforge
 
 ## Credentials
 
-One free API key: 200 requests/month, no card. Get it at [ibanforge.com](https://ibanforge.com?src=n8n) (key dialog) or straight from the API:
+The node needs an IBANforge API key. The quickest one needs no e-mail and no card:
+
+```bash
+curl -X POST https://api.ibanforge.com/v1/keys/generate \
+  -H "Content-Type: application/json" \
+  -d '{"source": "n8n"}'
+```
+
+The answer carries an `ifk_…` key, shown once, worth 25 requests a month on every endpoint. Paste it into the node's IBANforge API credentials.
+
+To raise that same key to 200 requests a month, claim it once it has served a call: `POST https://api.ibanforge.com/v1/keys/claim` with the key in the `Authorization: Bearer ifk_…` header, then the six-digit code mailed to the address you give for this. The steps are in [the API keys guide](https://ibanforge.com/docs/api-keys?src=n8n).
+
+Prefer to give an address from the start? Send it in the same call and the key starts at 200 requests a month:
 
 ```bash
 curl -X POST https://api.ibanforge.com/v1/keys/generate \
@@ -33,14 +49,14 @@ curl -X POST https://api.ibanforge.com/v1/keys/generate \
   -d '{"email": "you@company.com", "source": "n8n"}'
 ```
 
-Paste the `ifk_…` key into the node's IBANforge API credentials.
+The [key dialog on ibanforge.com](https://ibanforge.com?src=n8n) does the same from a browser.
 
 ## Honest limits
 
-- The bank-code check tells you what the **national register** says about the code inside the IBAN — it never claims the *account* exists or matches a name (that is Verification of Payee, a regulated-PSP scheme).
+- The bank-code check tells you what the **national register** says about the code inside the IBAN. It never claims the *account* exists or matches a name (that is Verification of Payee, a regulated-PSP scheme).
 - Sanctions screening is **bank-level (BIC8)**, not name-level, and is not a regulated AML/CFT product.
 - Full API reference: [ibanforge.com/docs](https://ibanforge.com/docs?src=n8n) · data provenance: [ibanforge.com/docs/data-sources](https://ibanforge.com/docs/data-sources?src=n8n)
 
 ## License
 
-[MIT](../../LICENSE)
+[MIT](LICENSE)

package/dist/credentials/IbanForgeApi.credentials.js

@@ -4,6 +4,7 @@ exports.IbanForgeApi = void 0;
 class IbanForgeApi {
     name = 'ibanForgeApi';
     displayName = 'IBANforge API';
+    icon = { light: 'file:ibanforge.svg', dark: 'file:ibanforge.svg' };
     documentationUrl = 'https://ibanforge.com/docs/api-keys?src=n8n';
     properties = [
         {
@@ -12,7 +13,10 @@ class IbanForgeApi {
             type: 'string',
             typeOptions: { password: true },
             default: '',
-            description: 'Free key: 200 requests/month, no card — POST your email to https://api.ibanforge.com/v1/keys/generate or use the dialog at https://ibanforge.com?src=n8n',
+            // 24/09/2026 : l'ancien texte n'offrait que la clé avec adresse (« POST
+            // your email »). La clé sans e-mail passe en premier ; `source: n8n`
+            // garde l'attribution de la porte d'entrée (src/lib/key-origins.ts).
+            description: 'A key that needs no e-mail and no card: POST https://api.ibanforge.com/v1/keys/generate with {"source":"n8n"} returns an ifk_ key worth 25 requests a month, raised to 200 a month once claimed at /v1/keys/claim. Or use the dialog at https://ibanforge.com?src=n8n',
         },
     ];
     authenticate = {

package/dist/credentials/ibanforge.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60">
+  <rect width="60" height="60" rx="12" fill="#14263f"/>
+  <path d="M14 40 V20 h4 v20 z" fill="#c8742f"/>
+  <path d="M24 40 V20 h4 v8 l8 -8 h5.5 l-9 9 9.5 11 h-5.5 l-7 -8.5 -1 1 V40 z" fill="#f5f1e6"/>
+  <circle cx="45" cy="23" r="3" fill="#c8742f"/>
+</svg>

package/dist/nodes/IbanForge/IbanForge.node.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IbanForge = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
 /**
  * Declarative (routing-style) node: every operation maps straight onto the
- * REST API, no execute() code and zero runtime dependencies — the shape the
+ * REST API, no execute() code and zero runtime dependencies, the shape the
  * n8n verified-community-node programme requires (MIT + no deps + one
  * package per service).
  */
@@ -11,16 +12,17 @@ class IbanForge {
     description = {
         displayName: 'IBANforge',
         name: 'ibanForge',
-        icon: 'file:ibanforge.svg',
+        icon: { light: 'file:ibanforge.svg', dark: 'file:ibanforge.svg' },
         group: ['transform'],
         version: 1,
         subtitle: '={{$parameter["operation"]}}',
-        description: 'Validate IBANs against 6 national bank registers, resolve BIC/SWIFT codes, look up Swiss clearing data and run compliance pre-checks',
+        description: 'Validate IBANs and check the bank code against national bank registers, resolve BIC/SWIFT codes, look up Swiss clearing data and run compliance pre-checks',
         defaults: {
             name: 'IBANforge',
         },
-        inputs: ['main'],
-        outputs: ['main'],
+        inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+        outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+        usableAsTool: true,
         credentials: [
             {
                 name: 'ibanForgeApi',
@@ -43,7 +45,7 @@ class IbanForge {
                     {
                         name: 'Validate IBAN',
                         value: 'validateIban',
-                        action: 'Validate an IBAN',
+                        action: 'Validate IBAN',
                         description: 'Structure + checksum + issuing bank, bank-code check against the national register, SEPA and VoP reachability',
                         routing: {
                             request: {
@@ -58,7 +60,7 @@ class IbanForge {
                     {
                         name: 'Look Up BIC',
                         value: 'lookupBic',
-                        action: 'Look up a BIC or SWIFT code',
+                        action: 'Look up BIC or SWIFT code',
                         description: 'Resolve a BIC/SWIFT code into bank name, city, country and LEI',
                         routing: {
                             request: {
@@ -70,7 +72,7 @@ class IbanForge {
                     {
                         name: 'Look Up Swiss Clearing',
                         value: 'lookupChClearing',
-                        action: 'Look up a swiss BC number IID',
+                        action: 'Look up BC number or IID',
                         description: 'Swiss BC-Nummer / IID: institution, seat address, SIC/euroSIC/instant participation, QR-IID semantics',
                         routing: {
                             request: {
@@ -82,8 +84,8 @@ class IbanForge {
                     {
                         name: 'Compliance Check',
                         value: 'complianceCheck',
-                        action: 'Run a compliance pre check on an IBAN',
-                        description: 'Bank-level sanctions (OFAC + EU), FATF lists, SEPA/VoP reachability, 0-100 risk score — bank-level, not name screening',
+                        action: 'Run compliance check on IBAN',
+                        description: 'Bank-level sanctions (OFAC + EU), FATF lists, SEPA/VoP reachability, 0-100 risk score, at bank level and not by name',
                         routing: {
                             request: {
                                 method: 'POST',
@@ -103,7 +105,7 @@ class IbanForge {
                 type: 'string',
                 required: true,
                 default: '',
-                placeholder: 'DE89370400440532013000',
+                placeholder: 'e.g. DE89370400440532013000',
                 description: 'The IBAN to check (spaces are tolerated)',
                 displayOptions: {
                     show: {
@@ -117,7 +119,7 @@ class IbanForge {
                 type: 'string',
                 required: true,
                 default: '',
-                placeholder: 'COBADEFF',
+                placeholder: 'e.g. COBADEFF',
                 description: 'BIC8 or BIC11 to resolve',
                 displayOptions: {
                     show: {
@@ -131,7 +133,7 @@ class IbanForge {
                 type: 'string',
                 required: true,
                 default: '',
-                placeholder: '230',
+                placeholder: 'e.g. 230',
                 description: 'Swiss institution identifier (3-5 digits) or QR-IID (30000-31999)',
                 displayOptions: {
                     show: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "n8n-nodes-ibanforge",
-  "version": "0.1.1",
-  "description": "IBAN validation, BIC/SWIFT lookup, Swiss clearing and compliance pre-checks for n8n workflows — backed by 6 national bank registers (121k+ BIC entries, 89 countries)",
+  "version": "0.1.3",
+  "description": "IBAN validation, BIC/SWIFT lookup, Swiss clearing and compliance pre-checks for n8n workflows, backed by national bank registers (121k+ BIC entries, 89 IBAN countries)",
   "keywords": [
     "n8n-community-node-package",
     "iban",
@@ -28,7 +28,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "build": "tsc && mkdir -p dist/nodes/IbanForge && cp nodes/IbanForge/ibanforge.svg nodes/IbanForge/IbanForge.node.json dist/nodes/IbanForge/",
+    "build": "tsc && mkdir -p dist/nodes/IbanForge dist/credentials && cp nodes/IbanForge/ibanforge.svg nodes/IbanForge/IbanForge.node.json dist/nodes/IbanForge/ && cp credentials/ibanforge.svg dist/credentials/",
     "lint": "tsc --noEmit"
   },
   "files": [
@@ -43,6 +43,9 @@
       "dist/nodes/IbanForge/IbanForge.node.js"
     ]
   },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
   "devDependencies": {
     "n8n-workflow": "^2.16.0",
     "typescript": "^5.6.0"