Introduction

Welcome to PayNode Protocol

PayNode is a stateless, non-custodial Machine-to-Machine (M2M) payment gateway. It is designed to bridge the gap between AI Agents and the API economy.

Currently, if an AI Agent hits an API that requires a credit card, it gets stuck. PayNode solves this by standardizing the HTTP 402 Payment Required status code, allowing Agents to autonomously pay for digital resources using USDC on Base L2.

🌟 Why PayNode?

  • Agent-Native: Built specifically for autonomous LLMs and scraping scripts. No UI required.
  • Deterministic: Runs entirely on-chain on Base L2. No central databases, no KYC.
  • Stateless Verification: Merchants verify payments via cryptographic transaction receipts (TxHash). No need to maintain complex order states.
  • Fair Economics: A hardcoded, atomic split. 99% of the payment goes directly to the Merchant’s wallet. 1% is routed to the Protocol Treasury.

📚 Documentation Navigation

To get started, explore the sections below:

  1. Protocol (x402): Understand the HTTP handshake and how the 402 status code is utilized.
  2. Architecture: Deep dive into the smart contracts and the “Don’t Trust, Verify” philosophy.
  3. JavaScript SDK: Detailed guides for integrating PayNode in TypeScript/Node.js environments.
  4. Python SDK: Detailed guides for integrating PayNode in Python (FastAPI/Requests) environments.
  5. Smart Contracts: Contract addresses, ABI details, and Mainnet verification.

🚀 The Vision

We believe in a Sovereign AI Future where machines can frictionlessly transact with one another. PayNode provides the missing financial primitive for the machine economy.

Protocol (x402)