n8n x402 Integration
n8n is a powerful open-source alternative to commercial automation platforms, offering a visual workflow editor with extensive integration capabilities. It combines the flexibility of self-hosting with enterprise-grade features, making it ideal for organizations that need control over their automation infrastructure. The platform's HTTP request nodes and custom function capabilities make x402 payment integration straightforward and customizable.
💻 x402 Integration Method
Integration Type: Custom Code
n8n's HTTP request nodes and custom function capabilities enable flexible x402 payment integration with full control over implementation and error handling.
Setup Complexity
Maintenance
Documentation
Examples
Installation & Setup
Install the necessary packages to get started with x402 payments in n8n:
# Install the necessary packages npm install n8n x402-n8n
The x402-n8n package is a helper library that simplifies wrapping facilitators into n8n-compatible tools, bridging our facilitator ecosystem with your agent framework.
Integration Examples
x402 Payment Processing Workflow
Create an n8n workflow that processes x402 payments with error handling and notification systems
// Custom Function node for x402 payment
const x402ApiKey = $node["Set API Key"].json["api_key"];
const paymentData = {
amount: $json.amount,
recipient: $json.recipient,
memo: $json.memo || ""
};
try {
const response = await $http.request({
method: 'POST',
url: 'https://api.xpay.sh/payments',
headers: {
'Authorization': `Bearer ${x402ApiKey}`,
'Content-Type': 'application/json'
},
body: paymentData
});
return {
success: true,
transaction_id: response.data.id,
status: response.data.status,
timestamp: new Date().toISOString()
};
} catch (error) {
return {
success: false,
error: error.message,
timestamp: new Date().toISOString()
};
}Prerequisites:
n8n installation
x402 API credentials
Basic workflow knowledge
Choosing Your Facilitator
The X402PaymentTool is generic and works with any facilitator that has a compatible client. Here's how you might initialize different clients based on your specific needs:
For Enterprise (CDP)
import { CDPClient } from 'x402-facilitators';
const client = new CDPClient({ apiKey: "..." });See the CDP Facilitator Guide for details.
For Zero Fees (Mogami)
import { MogamiClient } from 'x402-facilitators';
const client = new MogamiClient({ walletPk: "..." });See the Mogami Facilitator Guide for details.
For Developer Experience (thirdweb)
import { ThirdwebClient } from 'x402-facilitators';
const client = new ThirdwebClient({ secretKey: "..." });See the thirdweb Facilitator Guide for details.
Custom Setup
// Use any facilitator from our hub
import { CustomClient } from 'x402-facilitators';
const client = new CustomClient({ config: "..." });Browse all 8 facilitators in our hub.
Quick Info
Category
Workflow Orchestration
Primary Language
TypeScript
License
Sustainable Use License
Latest Version
1.62.0
Community Stats
GitHub Stars
47,000
Weekly Downloads
45,000
Community Size
Large
Payment-Enabled Use Cases
Business process automation
Data synchronization workflows
API integration and orchestration
ETL data processing
Monitoring and alerting systems
E-commerce automation
Marketing workflow automation
Financial data processing
Strengths
Open source with self-hosting option
Extensive integration library (400+)
User-friendly visual interface
Strong community and active development
Flexible custom function capabilities
Good documentation and examples
Enterprise features available
Fair use licensing model
Limitations
Requires technical setup for self-hosting
Learning curve for advanced features
Limited AI-specific capabilities
Performance considerations for complex workflows
Enterprise features require licensing
Custom integrations need development
Resource usage scales with workflow complexity
Sustainable Use License restrictions
Get the Complete Template
Access a complete, runnable repository with working n8n x402 integration examples, configuration templates, and step-by-step setup guides.
View on GitHub: n8n x402 TemplateReady to Build Payment-Enabled Agents?
Get started with our complete n8n x402 integration template. Includes working examples, facilitator configurations, and production-ready code.