@orvion/n8n-nodes-orvion 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Orvion
+
+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

@@ -0,0 +1,316 @@
+# n8n-nodes-orvion
+
+This is an n8n community node for [Orvion](https://orvion.sh) - the payment orchestration platform for AI agents.
+
+Create payment charges and receive `checkout_url` for payment collection. Perfect for:
+
+- AI agent workflows that need to charge for services
+- Automated billing flows
+- Pay-per-use API integrations
+- Crypto/stablecoin payment collection
+
+## Installation
+
+### In n8n (Recommended)
+
+1. Go to **Settings** > **Community Nodes**
+2. Click **Install**
+3. Enter `n8n-nodes-orvion`
+4. Click **Install**
+
+### Manual Installation
+
+```bash
+npm install n8n-nodes-orvion
+```
+
+## Prerequisites
+
+1. An Orvion account ([sign up here](https://orvion.sh))
+2. An API key from your Orvion dashboard (Settings > API Keys)
+
+## Credentials
+
+1. In n8n, go to **Credentials** > **New**
+2. Search for "Orvion API"
+3. Enter your API key
+4. (Optional) Override the Base URL if testing with a local backend instance
+
+## Nodes
+
+This package provides **2 nodes**:
+
+| Node | Type | Description |
+|------|------|-------------|
+| **Orvion** | Action | Create charges with optional "Wait for Payment" feature |
+| **Orvion Trigger** | Trigger | Receive webhook events when payments succeed/fail |
+
+---
+
+## Orvion Node (Action)
+
+### Wait for Payment (Recommended)
+
+The **Wait for Payment** feature allows you to create a charge and automatically pause the workflow until the customer pays. This enables a single-workflow pattern where:
+
+1. Your workflow creates a charge
+2. Workflow pauses (status: "Waiting...")
+3. Customer pays on the checkout page
+4. Workflow resumes automatically with payment data
+5. Your business logic continues
+
+**Enable "Wait for Payment":**
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| **Wait for Payment** | No | Toggle ON to pause workflow until payment completes |
+| Amount | Yes | Charge amount (e.g., 0.50) |
+| Currency | Yes | Currency code (default: USDC) |
+| Flow Slug | No | Billing flow for x402 config |
+| Customer Ref | No | Your customer identifier |
+| Resource Ref | No | Resource being purchased |
+| **Notify Email** | Yes | Email to send checkout URL to |
+
+**Output after payment:**
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "charge_id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "succeeded",
+  "is_paid": true,
+  "is_pending": false,
+  "is_failed": false,
+  "amount": "0.50",
+  "currency": "USDC",
+  "tx_hash": "5nwz8X3Lgf8dqwV8EKQ2...",
+  "payer_address": "0x1234...5678",
+  "confirmed_at": "2025-01-08T12:00:00Z"
+}
+```
+
+### Create Charge (Without Wait)
+
+If "Wait for Payment" is OFF, the node creates a charge and immediately returns with the `checkout_url`. Use this when you prefer the 2-workflow pattern with `Orvion Trigger`.
+
+**Output (immediate):**
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "pending",
+  "amount": "0.50",
+  "currency": "USDC",
+  "checkout_url": "https://pay.orvion.sh/checkout/550e8400-..."
+}
+```
+
+#### 2. Check Payment
+
+Check payment status with optional reference validation. Returns `is_paid` boolean for easy workflow branching.
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| Charge ID | Yes | The charge ID to check (use `{{ $json.charge_id }}` from Create Charge) |
+| Expected Customer Ref | No | Optional: Validate customer reference matches |
+| Expected Resource Ref | No | Optional: Validate resource reference matches |
+
+**Output:**
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "succeeded",
+  "is_paid": true,
+  "is_terminal": true,
+  "amount": "0.50",
+  "currency": "USDC",
+  "checkout_url": "https://pay.orvion.sh/checkout/550e8400-...",
+  "tx_hash": "5nwz8X3Lgf8dqwV8EKQ2...",
+  "payer_address": "0x1234...5678",
+  "confirmed_at": "2025-01-08T12:00:00Z",
+  "validation": {
+    "valid": true,
+    "customer_ref_match": true,
+    "resource_ref_match": true
+  }
+}
+```
+
+**Helper booleans:**
+- `is_paid`: `true` if status is `succeeded`
+- `is_terminal`: `true` if status is `succeeded`, `failed`, or `expired` (no more polling needed)
+
+#### 3. Share Checkout URL
+
+Send the checkout URL via email to a customer.
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| Charge ID | Yes | The charge ID to share (use `{{ $json.charge_id }}` from Create Charge) |
+| Recipient Email | Yes | Customer's email address |
+
+---
+
+## Orvion Trigger Node (NEW)
+
+The **Orvion Trigger** node automatically registers a webhook endpoint with Orvion and triggers your workflow when payment events occur.
+
+### Events
+
+| Event | Description |
+|-------|-------------|
+| Payment Succeeded | Triggered when payment is confirmed on blockchain |
+| Payment Failed | Triggered when payment fails |
+| Payment Cancelled | Triggered when payment is cancelled |
+
+### Output
+
+```json
+{
+  "event": "billing.transaction.succeeded",
+  "timestamp": "2025-01-08T12:00:00Z",
+  "charge_id": "550e8400-e29b-41d4-a716-446655440000",
+  "is_paid": true,
+  "is_failed": false,
+  "is_cancelled": false,
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "status": "succeeded",
+  "amount": "0.50",
+  "currency": "USDC",
+  "tx_hash": "5nwz8X3Lgf8dqwV8EKQ2...",
+  "payer_address": "0x1234...5678",
+  "customer_ref": "user_123",
+  "resource_ref": "article:42"
+}
+```
+
+### How It Works
+
+1. When you activate your workflow, the trigger automatically registers its webhook URL with Orvion
+2. When a payment event occurs, Orvion sends the event data to your n8n instance
+3. Your workflow continues with the payment data
+4. When you deactivate the workflow, the webhook endpoint is automatically removed
+
+---
+
+## Recommended Workflow Patterns
+
+### Pattern 1: Single Workflow with Wait for Payment (Recommended)
+
+**Best for:** Most use cases. Everything in one workflow!
+
+```
+[Manual Trigger] 
+  → [Orvion: Create Charge]
+      - Wait for Payment: ON
+      - Notify Email: customer@example.com
+  → [PAUSES - waiting for payment]
+  → [RESUMES when customer pays]
+  → [Your business logic]
+```
+
+The workflow pauses after creating the charge, and automatically resumes when the customer completes payment. No need for a second workflow or polling!
+
+### Pattern 2: Two Workflows with Orvion Trigger
+
+**Best for:** When you need separate workflows for charge creation and fulfillment.
+
+**Workflow 1: Collect Payment**
+```
+[Your Trigger] 
+  → [Orvion: Create Charge + Notify Email]
+  → [Respond with checkout_url]
+```
+
+**Workflow 2: Handle Payment (separate workflow)**
+```
+[Orvion Trigger: Payment Succeeded]
+  → [Your business logic]
+```
+
+The Orvion Trigger node automatically registers itself as a webhook, so when the customer pays, your second workflow fires immediately.
+
+### Pattern 3: API/Agent Integration
+
+**Best for:** APIs, apps, or agents that call your n8n workflow and need the checkout_url back.
+
+```
+[Webhook Trigger] 
+  → [Orvion: Create Charge]
+      - Wait for Payment: ON
+  → [PAUSES - waiting for payment]
+  → [RESUMES when customer pays]
+  → [Respond to Webhook with payment result]
+```
+
+Your app/agent calls the n8n webhook URL → waits → gets payment confirmation in the response.
+
+---
+
+## Complete Example: Order Processing
+
+### Single Workflow Pattern (Recommended)
+
+```
+[Webhook Trigger: POST /order]
+  → [Orvion: Create Charge]
+      Wait for Payment: ON
+      Amount: {{ $json.total }}
+      Currency: USDC
+      Customer Ref: {{ $json.customer_id }}
+      Resource Ref: order:{{ $json.order_id }}
+      Notify Email: {{ $json.customer_email }}
+  → [PAUSES - waiting for payment]
+  → [RESUMES when customer pays]
+  → [IF] {{ $json.is_paid }}
+      → [Update order status in your database]
+      → [Send confirmation email]
+      → [Trigger fulfillment]
+  → [ELSE]
+      → [Handle payment failure]
+```
+
+### Two Workflow Pattern (Legacy)
+
+**Workflow 1: Create Order** (triggered by your app)
+```
+[Webhook Trigger: POST /order]
+  → [Orvion: Create Charge]
+      Wait for Payment: OFF
+      Amount: {{ $json.total }}
+      Notify Email: {{ $json.customer_email }}
+  → [Respond to Webhook]
+      { "checkout_url": "{{ $json.checkout_url }}" }
+```
+
+**Workflow 2: Fulfill Order** (triggered by Orvion webhook)
+```
+[Orvion Trigger: Payment Succeeded]
+  → [Update order status in your database]
+  → [Send confirmation email]
+  → [Trigger fulfillment]
+```
+
+---
+
+## Local Development
+
+See the [n8n/dev](../dev) folder for Docker Compose setup for local testing.
+
+```bash
+cd n8n/dev
+cp .env.example .env
+# Edit .env with your values
+docker-compose up
+```
+
+## Support
+
+- [Orvion Documentation](https://docs.orvion.sh)
+- [GitHub Issues](https://github.com/orvion/agent-pay/issues)
+- [Discord Community](https://discord.gg/orvion)
+
+## License
+
+MIT

package/dist/credentials/OrvionApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class OrvionApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/OrvionApi.credentials.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrvionApi = void 0;
+class OrvionApi {
+    constructor() {
+        this.name = 'orvionApi';
+        this.displayName = 'Orvion API';
+        this.documentationUrl = 'https://docs.orvion.sh/api/authentication';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Your Orvion API key. Get it from the Orvion dashboard under Settings > API Keys.',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.orvion.sh/v1',
+                required: false,
+                description: 'The Orvion API base URL. Defaults to production. Only override if testing with a local backend instance.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-API-Key': '={{$credentials.apiKey}}',
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'n8n-nodes-orvion/0.1.0',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/health',
+                method: 'GET',
+                headers: {
+                    'X-API-Key': '={{$credentials.apiKey}}',
+                    'Content-Type': 'application/json',
+                },
+            },
+        };
+    }
+}
+exports.OrvionApi = OrvionApi;
+//# sourceMappingURL=OrvionApi.credentials.js.map

package/dist/credentials/OrvionApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrvionApi.credentials.js","sourceRoot":"","sources":["../../credentials/OrvionApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,WAAW,CAAC;QACnB,gBAAW,GAAG,YAAY,CAAC;QAC3B,qBAAgB,GAAG,2CAA2C,CAAC;QAC/D,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,kFAAkF;aAC/F;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,0BAA0B;gBACnC,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,0GAA0G;aACvH;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,WAAW,EAAE,0BAA0B;oBACvC,cAAc,EAAE,kBAAkB;oBAClC,YAAY,EAAE,wBAAwB;iBACtC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACR,WAAW,EAAE,0BAA0B;oBACvC,cAAc,EAAE,kBAAkB;iBAClC;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAhDD,8BAgDC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * n8n-nodes-orvion
+ *
+ * Orvion community node for n8n - Create payment-protected charges
+ * and wait for payment confirmation.
+ */
+export * from './credentials/OrvionApi.credentials';
+export * from './nodes/Orvion/Orvion.node';
+export * from './nodes/OrvionTrigger/OrvionTrigger.node';

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * n8n-nodes-orvion
+ *
+ * Orvion community node for n8n - Create payment-protected charges
+ * and wait for payment confirmation.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./credentials/OrvionApi.credentials"), exports);
+__exportStar(require("./nodes/Orvion/Orvion.node"), exports);
+__exportStar(require("./nodes/OrvionTrigger/OrvionTrigger.node"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,sEAAoD;AACpD,6DAA2C;AAC3C,2EAAyD"}

package/dist/nodes/Orvion/Orvion.node.d.ts

@@ -0,0 +1,10 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, IWebhookFunctions, IWebhookResponseData } from 'n8n-workflow';
+export declare class Orvion implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+    /**
+     * Webhook handler for Wait for Payment feature.
+     * Called when the payment callback is received from Orvion.
+     */
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}

package/dist/nodes/Orvion/Orvion.node.js

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Orvion = void 0;
+// Fixed timeout: 10 minutes
+const TIMEOUT_MS = 10 * 60 * 1000;
+class Orvion {
+    constructor() {
+        this.description = {
+            displayName: 'Orvion',
+            name: 'orvion',
+            icon: 'file:orvion.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["waitForPayment"] ? "Create & wait for payment" : "Create charge"}}',
+            description: 'Create a payment charge and optionally wait for payment completion. When "Wait for Payment" is enabled, the workflow pauses until the customer pays.',
+            defaults: {
+                name: 'Orvion',
+            },
+            inputs: ['main'],
+            outputs: ['main', 'main', 'main'],
+            outputNames: ['Success', 'Pending', 'Failed'],
+            credentials: [
+                {
+                    name: 'orvionApi',
+                    required: true,
+                },
+            ],
+            // Webhook configuration for Wait for Payment feature
+            webhooks: [
+                {
+                    name: 'default',
+                    httpMethod: 'POST',
+                    responseMode: 'onReceived',
+                    path: '={{ $nodeId }}',
+                    restartWebhook: true,
+                    isFullPath: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Wait for Payment',
+                    name: 'waitForPayment',
+                    type: 'boolean',
+                    default: false,
+                    description: 'When enabled, the workflow pauses after creating the charge and automatically resumes when the customer completes payment. This allows a single workflow to handle both charge creation and payment completion.',
+                },
+                {
+                    displayName: 'Amount',
+                    name: 'amount',
+                    type: 'number',
+                    typeOptions: {
+                        numberPrecision: 6,
+                    },
+                    default: 0.5,
+                    required: true,
+                    description: 'The charge amount (e.g., 0.50 for 50 cents)',
+                },
+                {
+                    displayName: 'Currency',
+                    name: 'currency',
+                    type: 'string',
+                    default: 'USDC',
+                    required: true,
+                    description: 'Currency code (e.g., USDC, EURC, USD)',
+                },
+                {
+                    displayName: 'Flow Slug',
+                    name: 'flowSlug',
+                    type: 'string',
+                    default: '',
+                    required: false,
+                    description: 'Billing flow slug for x402 payment configuration. If not provided, uses your organization\'s default receiver config.',
+                },
+                {
+                    displayName: 'Customer Reference',
+                    name: 'customerRef',
+                    type: 'string',
+                    default: '',
+                    required: false,
+                    description: 'Your internal customer ID or reference',
+                },
+                {
+                    displayName: 'Resource Reference',
+                    name: 'resourceRef',
+                    type: 'string',
+                    default: '',
+                    required: false,
+                    description: 'Identifies the protected resource being purchased (e.g., article:42, image:prompt-text)',
+                },
+                {
+                    displayName: 'Notify Email',
+                    name: 'notifyEmail',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    description: 'Email address to send the checkout URL to. The customer will receive an email with a link to complete payment.',
+                    placeholder: 'customer@example.com',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const successItems = [];
+        const pendingItems = [];
+        const failedItems = [];
+        // Get static data for storing state across wait/resume
+        const waitData = this.getWorkflowStaticData('node');
+        const credentials = await this.getCredentials('orvionApi');
+        const baseUrl = credentials.baseUrl;
+        const apiKey = credentials.apiKey;
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const waitForPayment = this.getNodeParameter('waitForPayment', i, false);
+                const amount = this.getNodeParameter('amount', i);
+                const currency = this.getNodeParameter('currency', i);
+                const flowSlug = this.getNodeParameter('flowSlug', i, '');
+                const customerRef = this.getNodeParameter('customerRef', i, '');
+                const resourceRef = this.getNodeParameter('resourceRef', i, '');
+                const notifyEmail = this.getNodeParameter('notifyEmail', i, '');
+                const body = {
+                    amount: amount.toString(),
+                    currency,
+                };
+                if (flowSlug)
+                    body.flow_slug = flowSlug;
+                if (customerRef)
+                    body.customer_ref = customerRef;
+                if (resourceRef)
+                    body.resource_ref = resourceRef;
+                if (notifyEmail)
+                    body.notify_email = notifyEmail;
+                // If waitForPayment is enabled, add callback_url for webhook-based waiting
+                if (waitForPayment) {
+                    // Get the resume URL and node ID to construct the proper callback URL
+                    // n8n requires the format: ${resumeUrl}/${nodeId} for waiting webhooks
+                    let callbackUrl;
+                    try {
+                        const resumeUrl = this.evaluateExpression('{{ $execution.resumeUrl }}', i);
+                        const nodeId = this.evaluateExpression('{{ $nodeId }}', i);
+                        if (resumeUrl && nodeId) {
+                            // The callback URL must include the nodeId for n8n to route it correctly
+                            callbackUrl = `${resumeUrl}/${nodeId}`;
+                        }
+                    }
+                    catch (e) {
+                        // Expression evaluation failed, try alternative method
+                        console.warn('[Orvion] Could not evaluate expressions for resume URL:', e);
+                    }
+                    if (callbackUrl) {
+                        body.callback_url = callbackUrl;
+                    }
+                    else {
+                        // Log warning but continue - the workflow will work but won't auto-resume
+                        console.warn('[Orvion] Could not determine callback URL for wait-for-payment. Callback will not be set.');
+                    }
+                }
+                // Create the charge
+                const response = await this.helpers.httpRequest({
+                    method: 'POST',
+                    url: `${baseUrl}/charges`,
+                    headers: {
+                        'X-API-Key': apiKey,
+                        'Content-Type': 'application/json',
+                        'User-Agent': 'n8n-nodes-orvion/0.1.0',
+                    },
+                    body,
+                    json: true,
+                });
+                // Add convenience fields
+                const charge = {
+                    ...response,
+                    charge_id: response.id,
+                    is_paid: response.status === 'succeeded',
+                    is_pending: response.status === 'pending',
+                    is_failed: ['failed', 'expired', 'cancelled'].includes(response.status),
+                };
+                // If waitForPayment is enabled and charge is pending, pause execution
+                if (waitForPayment && charge.is_pending) {
+                    // Store state for when we resume
+                    waitData.waitingForPayment = true;
+                    waitData.chargeId = charge.id;
+                    // Calculate timeout date (fixed 10 minute timeout)
+                    const waitUntil = new Date(Date.now() + TIMEOUT_MS);
+                    // Put execution to wait until timeout or webhook callback is received
+                    await this.putExecutionToWait(waitUntil);
+                    // This code won't be reached until the workflow resumes via webhook
+                    // When it resumes, the webhook() method handles the callback data
+                    return [this.getInputData()];
+                }
+                const item = {
+                    json: charge,
+                    pairedItem: { item: i },
+                };
+                // Route based on status
+                if (charge.is_paid) {
+                    // Payment already succeeded (rare for new charges)
+                    successItems.push(item);
+                }
+                else if (charge.is_pending) {
+                    // Charge created, awaiting payment (most common)
+                    pendingItems.push(item);
+                }
+                else {
+                    // Charge failed/expired/cancelled
+                    failedItems.push(item);
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    failedItems.push({
+                        json: {
+                            error: error instanceof Error ? error.message : 'Unknown error',
+                            is_paid: false,
+                            is_pending: false,
+                            is_failed: true,
+                        },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        // Return 3 outputs: [Success, Pending, Failed]
+        return [successItems, pendingItems, failedItems];
+    }
+    /**
+     * Webhook handler for Wait for Payment feature.
+     * Called when the payment callback is received from Orvion.
+     */
+    async webhook() {
+        const req = this.getRequestObject();
+        const callbackData = req.body;
+        // Extract payment data from callback
+        const eventName = callbackData.event || 'unknown';
+        const paymentData = callbackData.data || callbackData;
+        // Build output with convenience fields
+        const outputData = {
+            ...paymentData,
+            id: paymentData.id || '',
+            charge_id: paymentData.id || '',
+            status: paymentData.status || '',
+            amount: paymentData.amount || '',
+            currency: paymentData.currency || '',
+            created_at: paymentData.created_at || '',
+            updated_at: paymentData.updated_at || '',
+            is_paid: eventName === 'billing.transaction.succeeded',
+            is_pending: false,
+            is_failed: eventName === 'billing.transaction.failed',
+        };
+        // Return success response to Orvion and resume workflow with payment data
+        return {
+            webhookResponse: JSON.stringify({ success: true, message: 'Callback received' }),
+            workflowData: [
+                // Route to appropriate output based on payment status
+                outputData.is_paid ? [{ json: outputData }] : [], // Success output
+                [], // Pending output (not used on callback)
+                outputData.is_failed ? [{ json: outputData }] : [], // Failed output
+            ],
+        };
+    }
+}
+exports.Orvion = Orvion;
+//# sourceMappingURL=Orvion.node.js.map

package/dist/nodes/Orvion/Orvion.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Orvion.node.js","sourceRoot":"","sources":["../../../nodes/Orvion/Orvion.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/Orvion/orvion.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <defs>
+    <linearGradient id="orvionGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#8b5cf6;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <!-- Background circle -->
+  <circle cx="32" cy="32" r="30" fill="url(#orvionGradient)"/>
+  <!-- Dollar/payment symbol stylized as "O" for Orvion -->
+  <circle cx="32" cy="32" r="16" stroke="white" stroke-width="3" fill="none"/>
+  <!-- Payment arrow pointing right (represents flow/transaction) -->
+  <path d="M26 32h12M34 26l6 6-6 6" stroke="white" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/nodes/OrvionTrigger/OrvionTrigger.node.d.ts

@@ -0,0 +1,24 @@
+import { IHookFunctions, INodeType, INodeTypeDescription, IWebhookFunctions, IWebhookResponseData } from 'n8n-workflow';
+export declare class OrvionTrigger implements INodeType {
+    description: INodeTypeDescription;
+    webhookMethods: {
+        default: {
+            /**
+             * Check if a webhook endpoint already exists for this n8n webhook URL.
+             */
+            checkExists(this: IHookFunctions): Promise<boolean>;
+            /**
+             * Create a new webhook endpoint in Orvion.
+             */
+            create(this: IHookFunctions): Promise<boolean>;
+            /**
+             * Delete the webhook endpoint from Orvion.
+             */
+            delete(this: IHookFunctions): Promise<boolean>;
+        };
+    };
+    /**
+     * Handle incoming webhook events from Orvion.
+     */
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}

package/dist/nodes/OrvionTrigger/OrvionTrigger.node.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrvionTrigger = void 0;
+class OrvionTrigger {
+    constructor() {
+        this.description = {
+            displayName: 'Orvion Trigger',
+            name: 'orvionTrigger',
+            icon: 'file:orvion.svg',
+            group: ['trigger'],
+            version: 1,
+            subtitle: '={{$parameter["events"].join(", ")}}',
+            description: 'Triggers when a payment event occurs (e.g., payment succeeded, failed). Eliminates polling loops.',
+            defaults: {
+                name: 'Orvion Trigger',
+            },
+            inputs: [],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'orvionApi',
+                    required: true,
+                },
+            ],
+            webhooks: [
+                {
+                    name: 'default',
+                    httpMethod: 'POST',
+                    responseMode: 'onReceived',
+                    path: 'webhook',
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Events',
+                    name: 'events',
+                    type: 'multiOptions',
+                    required: true,
+                    default: ['billing.transaction.succeeded'],
+                    description: 'The events to listen to',
+                    options: [
+                        {
+                            name: 'Payment Succeeded',
+                            value: 'billing.transaction.succeeded',
+                            description: 'Triggered when a payment is confirmed on the blockchain',
+                        },
+                        {
+                            name: 'Payment Failed',
+                            value: 'billing.transaction.failed',
+                            description: 'Triggered when a payment fails',
+                        },
+                        {
+                            name: 'Payment Cancelled',
+                            value: 'billing.transaction.cancelled',
+                            description: 'Triggered when a payment is cancelled',
+                        },
+                    ],
+                },
+                {
+                    displayName: 'Description',
+                    name: 'description',
+                    type: 'string',
+                    default: '',
+                    description: 'Optional description for this webhook endpoint (shown in Orvion dashboard)',
+                    placeholder: 'n8n workflow: Order Processing',
+                },
+            ],
+        };
+        this.webhookMethods = {
+            default: {
+                /**
+                 * Check if a webhook endpoint already exists for this n8n webhook URL.
+                 */
+                async checkExists() {
+                    const webhookUrl = this.getNodeWebhookUrl('default');
+                    const credentials = await this.getCredentials('orvionApi');
+                    const baseUrl = credentials.baseUrl;
+                    const apiKey = credentials.apiKey;
+                    try {
+                        // List all webhook endpoints and check if one matches our URL
+                        const response = await this.helpers.httpRequest({
+                            method: 'GET',
+                            url: `${baseUrl}/webhook-endpoints`,
+                            headers: {
+                                'X-API-Key': apiKey,
+                                'User-Agent': 'n8n-nodes-orvion/0.1.0',
+                            },
+                            json: true,
+                        });
+                        const existingEndpoint = response.endpoints.find((ep) => ep.url === webhookUrl && ep.is_active);
+                        if (existingEndpoint) {
+                            // Store the endpoint ID for later use
+                            const webhookData = this.getWorkflowStaticData('node');
+                            webhookData.webhookEndpointId = existingEndpoint.id;
+                            return true;
+                        }
+                        return false;
+                    }
+                    catch (error) {
+                        // If we get an error (e.g., 404, network), assume it doesn't exist
+                        return false;
+                    }
+                },
+                /**
+                 * Create a new webhook endpoint in Orvion.
+                 */
+                async create() {
+                    const webhookUrl = this.getNodeWebhookUrl('default');
+                    const events = this.getNodeParameter('events');
+                    const description = this.getNodeParameter('description', '');
+                    const credentials = await this.getCredentials('orvionApi');
+                    const baseUrl = credentials.baseUrl;
+                    const apiKey = credentials.apiKey;
+                    try {
+                        const body = {
+                            url: webhookUrl,
+                            event_types: events,
+                        };
+                        if (description) {
+                            body.description = description;
+                        }
+                        const response = await this.helpers.httpRequest({
+                            method: 'POST',
+                            url: `${baseUrl}/webhook-endpoints`,
+                            headers: {
+                                'X-API-Key': apiKey,
+                                'Content-Type': 'application/json',
+                                'User-Agent': 'n8n-nodes-orvion/0.1.0',
+                            },
+                            body,
+                            json: true,
+                        });
+                        // Store the endpoint ID and secret for later use
+                        const webhookData = this.getWorkflowStaticData('node');
+                        webhookData.webhookEndpointId = response.id;
+                        webhookData.webhookSecret = response.secret;
+                        return true;
+                    }
+                    catch (error) {
+                        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                        throw new Error(`Failed to register webhook endpoint with Orvion: ${errorMessage}`);
+                    }
+                },
+                /**
+                 * Delete the webhook endpoint from Orvion.
+                 */
+                async delete() {
+                    const credentials = await this.getCredentials('orvionApi');
+                    const baseUrl = credentials.baseUrl;
+                    const apiKey = credentials.apiKey;
+                    const webhookData = this.getWorkflowStaticData('node');
+                    const endpointId = webhookData.webhookEndpointId;
+                    if (!endpointId) {
+                        // No endpoint ID stored, nothing to delete
+                        return true;
+                    }
+                    try {
+                        await this.helpers.httpRequest({
+                            method: 'DELETE',
+                            url: `${baseUrl}/webhook-endpoints/${endpointId}`,
+                            headers: {
+                                'X-API-Key': apiKey,
+                                'User-Agent': 'n8n-nodes-orvion/0.1.0',
+                            },
+                        });
+                        // Clear stored data
+                        delete webhookData.webhookEndpointId;
+                        delete webhookData.webhookSecret;
+                        return true;
+                    }
+                    catch (error) {
+                        // If endpoint is already gone (404), consider it a success
+                        if (error instanceof Error && error.message.includes('404')) {
+                            delete webhookData.webhookEndpointId;
+                            delete webhookData.webhookSecret;
+                            return true;
+                        }
+                        throw error;
+                    }
+                },
+            },
+        };
+    }
+    /**
+     * Handle incoming webhook events from Orvion.
+     */
+    async webhook() {
+        const req = this.getRequestObject();
+        const body = this.getBodyData();
+        // Extract event data
+        const eventName = body.event || req.headers['x-meshpay-event'] || 'unknown';
+        const eventData = body.data || body;
+        const timestamp = body.timestamp || new Date().toISOString();
+        // Build output item with helpful fields
+        const outputData = {
+            // Event metadata
+            event: eventName,
+            timestamp,
+            // Transaction data (flattened for easy access)
+            ...eventData,
+            // Convenience fields for common workflow patterns
+            charge_id: eventData.id || eventData.transaction_id,
+            is_paid: eventName === 'billing.transaction.succeeded',
+            is_failed: eventName === 'billing.transaction.failed',
+            is_cancelled: eventName === 'billing.transaction.cancelled',
+        };
+        return {
+            workflowData: [
+                this.helpers.returnJsonArray([outputData]),
+            ],
+        };
+    }
+}
+exports.OrvionTrigger = OrvionTrigger;
+//# sourceMappingURL=OrvionTrigger.node.js.map

package/dist/nodes/OrvionTrigger/OrvionTrigger.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrvionTrigger.node.js","sourceRoot":"","sources":["../../../nodes/OrvionTrigger/OrvionTrigger.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/OrvionTrigger/orvion.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <defs>
+    <linearGradient id="orvionGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366f1;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#8b5cf6;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <!-- Background circle -->
+  <circle cx="32" cy="32" r="30" fill="url(#orvionGradient)"/>
+  <!-- Dollar/payment symbol stylized as "O" for Orvion -->
+  <circle cx="32" cy="32" r="16" stroke="white" stroke-width="3" fill="none"/>
+  <!-- Payment arrow pointing right (represents flow/transaction) -->
+  <path d="M26 32h12M34 26l6 6-6 6" stroke="white" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@orvion/n8n-nodes-orvion",
+  "version": "0.1.1",
+  "description": "n8n community node for Orvion - Create payment-protected charges and wait for payment confirmation",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "orvion",
+    "payments",
+    "x402",
+    "crypto",
+    "stablecoin",
+    "USDC"
+  ],
+  "license": "MIT",
+  "homepage": "https://orvion.sh",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "author": {
+    "name": "Orvion",
+    "email": "ekinburakozturk@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orvion/agent-pay.git"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier --write .",
+    "lint": "eslint nodes credentials --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/OrvionApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Orvion/Orvion.node.js",
+      "dist/nodes/OrvionTrigger/OrvionTrigger.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.50.0",
+    "gulp": "^4.0.2",
+    "n8n-workflow": "^1.20.0",
+    "prettier": "^3.1.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}