n8n-nodes-x402
v0.2.0
Published
n8n nodes for x402 micropayments — accept payments, send payments, and query the SmartFlow Observatory endpoint catalogue (58k+ endpoints).
Maintainers
Readme
n8n-nodes-x402
n8n community nodes for x402 micropayments — accept payments, send payments, and query the SmartFlow Observatory endpoint catalogue (58k+ x402 endpoints) in your n8n workflows without writing code.
Nodes
X402 Trigger
Webhook trigger that accepts x402 micropayments. When a request arrives:
- Without payment → returns HTTP 402 with payment requirements
- With valid payment → verifies via facilitator, settles on-chain, passes data to workflow
Use it to monetize any n8n workflow — charge per API call, per automation run, per data request.
X402 Pay
Send x402 payments to protected endpoints. Handles the full payment flow:
- Sends request to target URL
- Receives 402 payment requirements
- Signs payment with your wallet
- Resends with payment header
- Returns the response
Use it to consume x402-protected APIs from your workflows.
X402 Catalog (new in v0.2.0)
Query the SmartFlow Observatory x402 endpoint catalogue from your workflow. Five operations:
- Get Catalog Stats — total catalogue size and per-source counts
- List Endpoints — filter by chain, registry source, HTTP status, strict v2 spec validity, on-chain volume, with pagination
- Search Endpoints — full-text search across endpoint URLs
- Get Endpoint Details — full record for a single endpoint by URL
- Get Active Endpoints — endpoints active in the last N days (1-90, default 7)
Use it to discover x402 services, segment them by quality signal (spec-valid + on-chain-volume + recent-activity), and feed downstream Pay nodes.
Installation
In your n8n instance:
Settings → Community Nodes → Install → n8n-nodes-x402Or via npm:
npm install n8n-nodes-x402Configuration
x402 API credential (for X402 Pay + X402 Trigger)
- Wallet Private Key — for signing payments (Pay node) or receiving (Trigger node)
- Facilitator URL — payment verification endpoint (default: x402.org)
- Receiver Address — your wallet address for receiving payments
SmartFlow Mapper API credential (for X402 Catalog, v0.2.0+)
- API Key — SmartFlow Observatory mapper key. Get one at smartflowproai.com/catalog (Hypersub Insider tier — 15 USDC/mo)
- Base URL — defaults to
https://api.smartflowproai.com
Supported Networks
- Base (Coinbase L2)
- Base Sepolia (testnet)
- Solana
- Solana Devnet
What is x402?
x402 is an open payment protocol that enables machine-to-machine micropayments via HTTP headers. Built by Coinbase, now a Linux Foundation standard with Google, Microsoft, Visa, Mastercard, and Stripe as founding members.
Links
- x402 Protocol
- SmartFlow Signal API — live x402-powered trading signals
- Solana x402 Facilitator
Author
Tom Smart — smartflowproai.com
