TARVOSOpen infrastructure

installable node

Tarvos x402

Tarvos x402 Paygate verifies and settles x402 v2 exact USDC payments on Solana through PayAI before starting a self-hosted n8n workflow.

Readiness
installable
Lifecycle
alpha
Version
0.1
Updated
Node recordTarvos x402
Integration
x402 payments
Provider
PayAI
Type
Trigger
Network
Solana

Installation guide

Prepare, install, configure, and connect.

EnvironmentSelf-hosted n8n
GitHub source setup
git clone https://github.com/TarvosTools/n8n-nodes-Tarvos-x402.git
cd n8n-nodes-Tarvos-x402
npm install
npm run dev
Open GitHub repository
  1. 01Prepare self-hosted n8n

    Use an n8n environment that supports community nodes.

    Environment
  2. 02Install Tarvos x402 Paygate

    Clone the GitHub repository, install its dependencies, and run the included n8n development environment with the Tarvos node loaded.

    Package
  3. 03Set wallet and payment amount

    Set the service name, Solana network, exact USDC amount, and public payout wallet directly on the trigger. PayAI is selected as the facilitator; no credentials or private key are required.

    Configuration
  4. 04Build the rest of the workflow

    Connect the fulfillment nodes that should run after payment settlement, then choose the response mode and test on Devnet before activating the production webhook.

    Workflow

Learn, install, and build from one node record.

Tutorial video

Complete x402 setup

A start-to-finish walkthrough of installation, wallet and amount configuration, response modes, and workflow testing.

Coming soon
Workflow template

x402Paygate

Inspect and download the n8n JSON workflow for releasing a protected automation path after an x402 payment event.

Machine formats

Use this record with an agent

Read the same node information as structured JSON or concise Markdown.

Trigger behavior exposed by this node.

trigger

Settled x402 payment

Exposes a GET paywall endpoint and starts the workflow only after PayAI verifies and settles the configured exact USDC payment on Solana.

Node configuration

Set the payment gate directly in the trigger.

PayAI is credential-free in v0.1. Configure the public payout wallet and exact payment requirements, then connect the fulfillment path.

  • Solana Mainnet and Solana Devnet only.
  • USDC only.
  • x402 v2 exact payments only.
  • No n8n credentials, seller private keys, or runtime dependencies.
  • The workflow starts only after PayAI confirms settlement.
RequiredserviceName

Service Name

Buyer-facing name for the paid service, included in the payment request and settled workflow output.

Default
Paid Service
Requirednetwork

Network

Solana network on which the exact USDC payment settles.

Default
Solana Devnet
Options
Solana Devnet · Solana Mainnet
Requiredfacilitator

Facilitator

Public facilitator used to verify and settle the payment. PayAI requires no credential in v0.1.

Default
PayAI
Options
PayAI
RequiredrequiredAmount

Required Amount (USDC)

Exact positive USDC amount, expressed with no more than six decimal places.

Default
0.01
RequiredpayoutWallet

Payout Wallet

Public Solana wallet address that receives the USDC payment.

Optionaloptions.responseMode

Response Mode

Return a settlement receipt immediately or wait and return the final workflow output.

Default
Immediately With Receipt
Options
Immediately With Receipt · When Workflow Finishes