Help
Everything about pay.agent on one page.
What is it?
pay.agent gives you a link, pay.agent/yourname, that anyone can pay in crypto. It is a simple front door to CoinPay, which holds the addresses and moves the money. pay.agent never holds your funds.
Getting started
- Sign in with CoinPay (or make a CoinPay account; it takes a minute).
- Pick your name.
- Choose where money lands:
- My CoinPay wallet: payments go to your CoinPay account's payout addresses. We make a small CoinPay business named
pay.agent/yournameto take them; you do not have to do anything with it. - My CoinPay business: payments go to a business you already run on CoinPay, using its payout wallets and keeping its settings.
- My CoinPay wallet: payments go to your CoinPay account's payout addresses. We make a small CoinPay business named
- No payout address yet? Paste one during setup (for example a Solana address for USDC on Solana). You can add more later in CoinPay and press Re-check coins.
Paying someone
Open their link, enter an amount in dollars and your email (CoinPay sends the receipt there), and continue to CoinPay's checkout. Pick any coin they take, or PayPal when they connected it, and pay. CoinPay brings you back to pay.agent, and the page turns green when the payment lands. A checkout is open for one hour.
Fees
pay.agent adds no fee. CoinPay takes its normal fee when it forwards the payment to you, and the payer pays their own network fee.
Coins
usdc_sol USDC on Solanausdc_base USDC on Baseusdc_pol USDC on Polygonusdc_eth USDC on Ethereumusdt_sol USDT on Solanausdt_pol USDT on Polygonusdt_eth USDT on Ethereumbtc Bitcoineth Ethersol Solanapol Polygonbch Bitcoin Cashdoge Dogecoinxrp XRPada Cardanobnb BNB
A link only offers coins its owner has a payout address for. New links also take USDC on Base, Polygon and Solana at an address the owner already has on that chain (an 0x address, or a Solana address); untick it at setup if that address is an exchange deposit address. Pick what your link takes on My link or with PUT /api/v1/me/coins.
Cards
Cards go through PayPal on CoinPay's checkout: a payer picks PayPal and pays by debit or credit card as a guest, no PayPal account needed. pay.agent never uses Stripe.
- You need a PayPal Business account and a REST app (developer.paypal.com, Apps & Credentials, Live). PayPal verifies who holds it.
- Connect it to the CoinPay business your link pays (
pay.agent/yournamein wallet mode): CoinPay dashboard, Business, PayPal. With no browser:POST https://coinpayportal.com/api/paypal/connectwith your CoinPay session (authorization: Bearerfrom/api/auth/login) and{"business_id": "…", "client_id": "…", "client_secret": "…"}. pay.agent cannot do this step for you: its CoinPay access can never touch PayPal settings. - Your next checkout shows PayPal and cards, and your link says so (
"card": truein the API).
Card money lands in your PayPal account, not your crypto wallet. Business id: GET /api/v1/me/coins.
Agents, API, CLI, MCP
Every link is an API, no key needed to pay someone:
GET /api/v1/users/:handle who, and which coins
POST /api/v1/users/:handle/payments {"amount_usd": 5, "payer_email": "me@example.com", "note": "thanks"}
-> {id, status, expires_at, checkout_url, status_url}
open checkout_url (CoinPay) to pay in any coin they take, or PayPal
GET /api/v1/payments/:id status: pending, confirmed, forwarded, completed (PayPal), expired
Your own payments, with the API key from My link:
GET /api/v1/me -H 'authorization: Bearer pa_…'
GET /api/v1/me/coins payable (has a wallet), accepts (your pick), coins + card (what payers see)
PUT /api/v1/me/coins {"coins": ["usdc_base", "usdc_sol", "sol", "paypal"]} or {"coins": "all"}
{"add_stablecoins": true}: USDC on Base/Polygon/Solana at your existing addresses
{"recheck": true}: read your CoinPay wallets again
Claiming with no browser takes the same choices: POST /api/v1/claim with "coins" and "stablecoins": false to skip the USDC default.
Webhooks: pay.agent POSTs payment.created, payment.paid, payment.expired, payment.failed, invoice.created, invoice.paid, invoice.overdue, invoice.cancelled for your link to your URL, as signed CloudEvents (Standard Webhooks, via @profullstack/webhooks), retried for about three days. Add one on My link or with your key:
GET /api/v1/webhooks your endpoints and the event types
POST /api/v1/webhooks {"url": "https://example.com/hook", "events": ["payment.*"]} -> {endpoint, secret}
POST /api/v1/webhooks/:id/test send webhook.test now
POST /api/v1/webhooks/:id/rotate a new signing secret
GET /api/v1/webhooks/deliveries the delivery log
DELETE /api/v1/webhooks/:id
Invoices, sent through CoinPay as you (CoinPay emails the pay link; a repeat sends the next ones):
POST /api/v1/invoices {"to_email": "pat@example.com", "description": "Logo", "amount_usd": 49,
"due_date": "2026-11-30", "recurrence": "monthly", "email": true}
GET /api/v1/invoices yours, with the key
GET /api/v1/invoices/:id public: status (sent, overdue, paid, cancelled), address, exact amount
bunx @profullstack/payagent alice 5 --email=me@example.com pay alice $5: prints the CoinPay checkout link bunx @profullstack/payagent status <payment-id> bunx @profullstack/payagent invoice pat@example.com 49 Logo --repeat=monthly bunx @profullstack/payagent webhook add https://example.com/hook payment.paid bunx @profullstack/payagent the TUI claude mcp add payagent -- bunx @profullstack/payagent mcp
Your data
We keep your CoinPay name and email, your handle, which business your link pays, and your CoinPay sign-in, sealed with a key kept only in pay.agent's memory, never on disk: after a restart or when your chosen time runs out, your link pauses until you sign in again. Payments to you are listed for you only. Sign out removes the session; to delete everything, use Delete my link on My link.
Reaching pay.agent
pay.agent is a Moshpit name. Without Moshpit DNS, use pay.agent.pit.world: the same site.