Description

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:

1. Sends request to target URL
2. Receives 402 payment requirements
3. Signs payment with your wallet
4. Resends with payment header
5. 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-x402

Or via npm:

npm install n8n-nodes-x402

Configuration

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

License

MIT