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

Log in, create a key and a link, and get paid by humans and agents.

Quickstart: Agent

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

Integrations

MCP setup

Connect Claude Code or 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.

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 in free public beta on Base Sepolia (testnet). 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

One price at launch: 1% per payment. No fixed costs, no monthly fees, no rolling reserve, no chargebacks. The beta is free — the fee rate is controlled by GENESISPAY_FEE_BPS (basis points; 100 = 1%, 0 during beta).

The fee is currently recorded as a billing line item on each payment (fee_usdc_minor) and shown in the dashboard activity. It is not deducted from the settlement amount: the on-chain transfer moves the full amount to the merchant, and the 1% is tracked separately for later invoicing. Amounts are shown to people in € / $ (EURC settles in euros, USDC in dollars); the token symbol appears only in receipts and activity detail.