x402

n8n nodes for x402 micropayments — accept payments, send payments, and query the SmartFlow Observatory endpoint catalogue (58k+ endpoints).

Package Information

Released: 4 mo ago
Downloads: 15 weekly / 33 monthly
Latest Version: 0.2.0
Author: Tom Smart

Available Nodes

x402 Trigger icon
x402 Trigger
Webhook trigger that accepts x402 micropayments — returns 402 for unpaid requests and settles paid ones
x402 Pay icon
x402 Pay
Make an HTTP request to an x402-protected endpoint — automatically handles 402 payment flow
x402 Catalog icon
x402 Catalog
Query the SmartFlow Observatory x402 endpoint catalogue — 58k+ endpoints, queryable by URL, registry source, chain, status, spec-validity, on-chain volume, and recent activity.

Documentation

n8n-nodes-x402

npm
License: MIT

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

Author

Tom Smart — smartflowproai.com

License

MIT

Discussion