PincerPay

The payment gateway for the agentic economy. Accept payments from AI agents. Add a few lines of code. Settle instantly in USDC.

For merchants: sign up in 2 minutes, no browser

npx @pincerpay/cli signup
# email + password + 6-digit code from your inbox

npx @pincerpay/cli bootstrap-merchant --name "Acme Co" --chains "solana,polygon"
# → generates non-custodial wallets, creates merchant, mints API key
# → prints env vars ready to paste into `vercel env add`

That's the full onboarding flow. Terminal-only. Phantom + MetaMask compatible wallets generated locally. PincerPay never sees your keys. See docs/onboarding and docs/cli for full reference.

Architecture

Agent → 402 Challenge → Sign USDC Transfer → PincerPay Facilitator → Blockchain → Merchant

PincerPay is a non-custodial x402 facilitator. When an AI agent hits a merchant API and gets HTTP 402, the agent signs a USDC transfer. PincerPay verifies the signature, broadcasts to the blockchain, and confirms settlement.

Monorepo Structure

Quick Start

Prerequisites

• Node.js 22+
• pnpm 10+
• PostgreSQL (Supabase recommended)

Install

pnpm install

Build

pnpm build

Development

# Start all services
pnpm dev

# Start individual services
pnpm --filter @pincerpay/facilitator dev
pnpm --filter @pincerpay/dashboard dev

Database

# Generate migrations from schema
pnpm db:generate

# Push schema to database
pnpm db:push

Onboarding scripts

Provision a merchant from the command line, with no dashboard click-through.

# Generate non-custodial wallets only (no DB)
pnpm create-wallets

# End-to-end: generate wallets, create merchant, mint API key
DATABASE_URL=postgresql://... pnpm bootstrap-merchant \
  --name "My Merchant" --auth-user-id <supabase-uuid>

# Mint a key for an existing merchant
DATABASE_URL=postgresql://... pnpm create-api-key list
DATABASE_URL=postgresql://... pnpm create-api-key create --merchant <id|name> --label "Production"

The same flows are exposed as MCP tools (bootstrap-wallets, bootstrap-merchant, create-api-key, list-merchants) in @pincerpay/mcp. See Merchant Onboarding.

Merchant SDK

import express from "express";
import { pincerpay } from "@pincerpay/merchant/express";

const app = express();

app.use(
  pincerpay({
    apiKey: process.env.PINCERPAY_API_KEY!,
    merchantAddress: "YOUR_SOLANA_ADDRESS",
    routes: {
      "GET /api/weather": {
        price: "0.01",
        chain: "solana",
        description: "Weather data",
      },
    },
  })
);

See @pincerpay/merchant README for Hono middleware, multi-chain config, and full API reference.

Agent SDK

import { PincerPayAgent } from "@pincerpay/agent";

const agent = await PincerPayAgent.create({
  chains: ["solana"],
  solanaPrivateKey: process.env.AGENT_SOLANA_KEY!,
});

// Automatic 402 handling
const response = await agent.fetch("https://api.example.com/weather");

See @pincerpay/agent README for spending policies, multi-chain setup, and Squads smart accounts.

Supported Chains

Deployment

The facilitator is deployed to Railway via Docker. The dashboard is deployed to Vercel. Solana is the primary chain (devnet). Base and Polygon are supported as optional secondary chains.

Tech Stack

• Runtime: Node.js 22 (pnpm monorepo + Turborepo)
• Facilitator: Hono + @x402/core + @x402/evm + @x402/svm + viem
• Dashboard: Next.js 15 + Tailwind CSS + Supabase Auth
• Database: PostgreSQL (Supabase) + Drizzle ORM
• CI: GitHub Actions (typecheck → test → build)
• Protocols: x402 (Coinbase)

Testing

pnpm test

47 tests across 5 suites (core, agent, merchant, facilitator).

Examples

Community

• Discord
• @pincerpay on X

License

MIT