Documentation

Build on GenesisPay

GenesisPay is the account layer for agentic payments, with two sides. Sellers publish one link that is a human checkout and an x402 API at the same time. Agent users give their AI a funded USDC account with spending limits and human approvals instead of a private key.

GenesisPay was formerly PeerDirect. As of 2026-08-07 every identifier carries the current name too: GENESISPAY_* variables, gp_ key prefixes, GENESISPAY-* headers. The former PEERPAY_* / pp_ names are no longer accepted; if you integrated before that date, see the changelog of the SDK you use.

Getting started

Overview

What GenesisPay is, the two sides, and how the pieces fit.

Quickstart: Seller

Quickstart: Agent

Give your agent a funded account with limits and make its first payment.

Integrations

WooCommerce

Install the official gateway, connect GenesisPay once, and accept verified USDC payments.

MCP setup

Connect ChatGPT or Claude through remote MCP, or Codex, Claude Code and Claude Desktop with the @genesis-tech/genesispay-mcp server.

Discovery

List services in the public directory and let agents find them.

Guides

Invoices

Create, finalize, email, and collect one-off invoices with hosted pages and PDFs.

Subscriptions & metering

Non-custodial payment mandates: one signature, then per-use charges and subscription renewals.

Let buyers log in with their GenesisPay account over OpenID Connect, then tie each one-click payment to them.

Reference

API reference

Every /api/v1 endpoint: auth, request and response shapes.

Webhooks

Signed payment events, verification, and retry behavior.

Control plane, data plane

Everything a human decides (login, funding, spending limits, approvals, key management) happens on the website. Everything a machine does (x402 payments, programmatic link creation, discovery, webhooks) happens behind API keys under /api/v1. Secrets are shown once at creation; GenesisPay stores only SHA-256 hashes.

Key formats

# Seller key: create links, settle payments
Authorization: Bearer gp_sk_<32 base62 chars>

# Agent key: pay x402 endpoints
Authorization: Bearer gp_ag_<32 base62 chars>

GenesisPay is live on Base mainnet. All money is USDC or EURC: decimal strings like "5.00" in requests, integer minor-unit strings (6 decimals) in stored data and responses.

Pricing and fees

Partner shops pay up to 1% per payment, with a minimum of $0.005 (or €0.005). The fee never exceeds half of the payment. No monthly fees, no rolling reserve, no chargebacks. The smallest price you can set for a new payment link, product, plan or invoice is $0.01 (or €0.01); below it the API answers 422 amount_below_minimum.

The fee is settled on-chain with the payment itself: the payer signs one transfer of the price minus the fee straight to the seller and a second transfer of the fee to GenesisPay, both directly from the payer's wallet. GenesisPay never holds the seller's money. Each payment's fee is shown in the dashboard activity. Amounts are shown to people in € / $ (EURC settles in euros, USDC in dollars); the token symbol appears only in receipts and activity detail.