Add script for Platform webhooks

Author: gcatanese

tools/hmac/README.md

@@ -20,3 +20,15 @@ npm list @adyen/api-library // check version of library and update if needed
 node calculateHmacPayments.js 11223344D785FBAE710E7F943F307971BB61B21281C98C9129B3D4018A57B2EB payload.json
 ```
 
+### Platform webhooks (AfP, Management API, etc..)
+
+Copy the content of the webhook in the payload2.json (or provide a different file), then run with: 
+`node calculateHmacPlatform.js {hmacKey} {path to JSON file}`
+```
+cd tools/hmac
+npm install 
+
+npm list @adyen/api-library // check version of library and update if needed
+
+node calculateHmacPlatform.js 11223344D785FBAE710E7F943F307971BB61B21281C98C9129B3D4018A57B2EB payload2.json
+```

tools/hmac/calculateHmacPlatform.js

@@ -0,0 +1,49 @@
+// script to calculate the HMAC signature of Banking/Management webhooks (where the signature is calculated over the
+// entire webhook payload)
+//
+// Run with: `node calculateHmacPlatform.js {hmacKey} {path to JSON file}`
+//
+// cd tools/hmac
+// node calculateHmacPlatform.js 11223344D785FBAE710E7F943F307971BB61B21281C98C9129B3D4018A57B2EB payload2.json
+
+const fs = require('fs');
+const crypto = require('crypto');
+
+// Ensure correct arguments
+if (process.argv.length !== 4) {
+    console.error("Usage: node calculateHmacPlatform.js <hmacKey> <payloadFile>");
+    process.exit(1);
+}
+
+const hmacKey = process.argv[2];
+const payloadFile = process.argv[3];
+
+// Check if file exists
+if (!fs.existsSync(payloadFile)) {
+    console.error(`Error: File '${payloadFile}' not found.`);
+    process.exit(1);
+}
+
+console.log(`Calculating HMAC signature with payload from '${payloadFile}'`);
+
+// Load payload as raw string
+let payload;
+try {
+    payload = fs.readFileSync(payloadFile, 'utf8');
+} catch (error) {
+    console.error(`Error reading file: ${error.message}`);
+    process.exit(1);
+}
+
+// Calculate HMAC signature
+function calculateHmacSignature(hmacKey, payload) {
+    const key = Buffer.from(hmacKey, 'hex');
+    const hmac = crypto.createHmac('sha256', key);
+    hmac.update(payload, 'utf8');
+    return hmac.digest('base64');
+}
+
+const signature = calculateHmacSignature(hmacKey, payload);
+
+console.log(`HMAC signature: ${signature}`);
+process.exit(0);

tools/hmac/payload2.json

@@ -0,0 +1,61 @@
+{
+    "data": {
+      "balancePlatform": "YOUR_BALANCE_PLATFORM",
+      "accountHolder": {
+        "contactDetails": {
+          "email": "[email protected]",
+          "phone": {
+            "number": "0612345678",
+            "type": "mobile"
+          },
+          "address": {
+            "houseNumberOrName": "23",
+            "city": "Amsterdam",
+            "country": "NL",
+            "postalCode": "12345",
+            "street": "Main Street 1"
+          }
+        },
+        "description": "Shelly Eller",
+        "legalEntityId": "LE00000000000000000001",
+        "reference": "YOUR_REFERENCE-2412C",
+        "capabilities": {
+          "issueCard": {
+            "enabled": true,
+            "requested": true,
+            "allowed": false,
+            "verificationStatus": "pending"
+          },
+          "receiveFromTransferInstrument": {
+            "enabled": true,
+            "requested": true,
+            "allowed": false,
+            "verificationStatus": "pending"
+          },
+          "sendToTransferInstrument": {
+            "enabled": true,
+            "requested": true,
+            "allowed": false,
+            "verificationStatus": "pending"
+          },
+          "sendToBalanceAccount": {
+            "enabled": true,
+            "requested": true,
+            "allowed": false,
+            "verificationStatus": "pending"
+          },
+          "receiveFromBalanceAccount": {
+            "enabled": true,
+            "requested": true,
+            "allowed": false,
+            "verificationStatus": "pending"
+          }
+        },
+        "id": "AH00000000000000000001",
+        "status": "active"
+      }
+    },
+    "environment": "test",
+    "timestamp": "2024-12-15T15:42:03+01:00",
+    "type": "balancePlatform.accountHolder.created"
+  }