pay.agent

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

  1. Sign in with CoinPay (or make a CoinPay account; it takes a minute).
  2. Pick your name.
  3. 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/yourname to 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.
  4. 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 Solana
usdc_base USDC on Base
usdc_pol USDC on Polygon
usdc_eth USDC on Ethereum
usdt_sol USDT on Solana
usdt_pol USDT on Polygon
usdt_eth USDT on Ethereum
btc Bitcoin
eth Ether
sol Solana
pol Polygon
bch Bitcoin Cash
doge Dogecoin
xrp XRP
ada Cardano
bnb 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.

  1. You need a PayPal Business account and a REST app (developer.paypal.com, Apps & Credentials, Live). PayPal verifies who holds it.
  2. Connect it to the CoinPay business your link pays (pay.agent/yourname in wallet mode): CoinPay dashboard, Business, PayPal. With no browser: POST https://coinpayportal.com/api/paypal/connect with your CoinPay session (authorization: Bearer from /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.
  3. Your next checkout shows PayPal and cards, and your link says so ("card": true in 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.