PayAgent Hackathon

Agents that can get paid.

Build an AI agent — or a product that uses one — that earns, spends, or gets paid on PayAgent. Real policy. Real on-chain payment. A demo a judge can click.

  • 24 hours
  • Teams of 2–4
  • Sepolia first
The brief

One prompt. Ship a payment.

Build an AI agent (or a product that uses one) that earns, spends, or gets paid on PayAgent — with a real policy, a real transaction, and a demo a judge can click.

1

Hour-1 gate

A recorded PayAgent payment

2

Hour-6 gate

Webhook or a second pay type

3

Final demo

Three minutes. Show the hash.

0

PayAgent fee

You pay network gas only

The rails

What you are building on

PayAgent is non-custodial crypto checkout for humans and AI agents. Payers sign in their own wallet. PayAgent records a payment only after the transaction is verified on-chain. It never holds keys and never broadcasts.

The live surface for this event is human checkout (links, invoices, public profiles), the merchant agent API (register, attach wallet, policy, preflight, record), HMAC-signed webhooks, and the public leaderboard.

Pay type Pays You send
link A payment link linkUsername, linkId
profile A username recipientUsername, amount, token, network
address A raw wallet recipientAddress, amount, token, network
Tracks

Pick one track. Touch PayAgent.

01

Agent commerce

Sell something and get paid via a payment link or invoice, then unlock the good — a file, API credit, role, or booking. Easiest “wow” demo.

02

Agent-to-agent

Agent A pays a username, a link, or a raw address after preflight. Show the tx on the leaderboard. This is the product story.

03

Merchant ops

A dashboard, Slack/Telegram bot, or CRM that creates batch links, verifies webhooks, and handles approval required. Strong for product teams.

Optional fourth track: trust and compliance — policy playground, deny over cap, require approval, or a public agent reputation view on the leaderboard.

Format

How the weekend runs

Duration

24 hours, or 8 hours plus overnight if you want sleep. Team size is 2–4.

Network

Default the room to Sepolia. Mainnet is a bonus, not a requirement. Optional extra: $1 USDC on Base.

Required artifact

One confirmed PayAgent payment and a 3-minute live demo or video. Show the hash.

Path

Preflight until ready. Send from the registered agent wallet. Record with txHash and an Idempotency-Key.

Hard rules

Fail closed. Keep the keys.

  1. Call GET /api/v1/pay/preflight and wait until ready is true.
  2. Send Idempotency-Key on every POST /api/v1/pay.
  3. Destination comes from the payment link or the public profile wallets — not a guessed address.
  4. The paying address must be a registered agent wallet.
  5. Policy stays on. Fail-closed is the point.
  6. Do not paste API keys into GitHub, Discord, or screenshots.
  7. Verify webhook signatures before acting on events.
  8. Sepolia is valid for judging. Mainnet is a bonus.
Judging

Four scores. Show the hash.

30%

Real PayAgent usage

Preflight, policy, pay, webhook or approval. A real txHash.

30%

Product usefulness

Would someone actually use this after the weekend?

20%

Demo clarity

Who paid, who got paid, policy, hash — in under 3 minutes.

20%

Craft / originality

Taste, scope control, something that is not a thin API wrapper.

No confirmed on-chain payment recorded through PayAgent means disqualification from the payments track. We do not score “AI quality” as a fifth criterion.

Prizes

Aim at the brief

Grand prize

Best overall against the four scores. Mainnet is not required.

Best agent commerce

Best pay-to-unlock, invoice, or webhook unlock.

Best agent-to-agent

Best pay plus leaderboard story.

Side prize: first on-chain pay, so mid-tier teams still have a win. Optional: best compliance UX if the fourth track runs.

Participant kit

What you should have in hour one

Most hackathon pain is setup, not ideas. Use Docs v2 only — v1 is archived. OpenAPI lives at GET /api/v1/openapi.json.

Item What you get
Workspace One sandbox workspace per team, API key from Merchant → API credentials
Agent One registered agent with a wallet attached
Policy One active policy already on. Do not turn it off.
Faucet Sepolia USDC/USDT plus a little ETH for gas
Payee fixtures A host profile and one sample payment link so you can pay without inventing a second merchant
Networks

Tokens and chains

Network ID Tokens
Ethereum ethereum USDC, USDT, ETH
Base base USDC, USDT, ETH
Solana solana USDC, USDT, SOL
Sepolia sepolia USDC, USDT, ETH — default for this event

USDC and USDT use 6 decimals. ETH and SOL use 18. $1 USDC is 1000000.

Ideas

Weekend-ship, then go deeper

Hour 1–8

Pay-to-unlock a gist, PDF, or Discord role. Tip-jar agent: chat tip @alice $2. Invoice bot from Slack. Leaderboard overlay for a stream.

Strong demos

Freelance agent that waits for payment_link.paid then delivers. Multi-agent marketplace on the leaderboard. Approval desk over $X. Batch checkout for a workshop.

Out of scope

Do not start here

  • Custodial wallets, or asking PayAgent to send the money for you
  • Headless auto-pay, session keys, or rebuilding the whole dashboard
  • Guessing destination addresses
  • Docs v1 — archived. Use v2 only
  • Mainnet-only demos — Sepolia is first-class
  • Rewards, referrals, or billing as the core product
FAQ

If you get stuck

The pay call returns NO_ACTIVE_POLICY The agent has no active policy. Activate one in the portal. Do not turn compliance off.
Preflight is not ready Read the payload. Usual causes: missing wallet, network or token not allowed, amount over cap, or destination not resolvable.
We sent the tx but POST /pay fails Check that tx.from is the registered agent wallet, tx.to matches the resolved destination, token, decimals, and network match, and you passed Idempotency-Key.
Where does the money go? For a link, from GET /payment-links/{linkId}. For a profile, from GET /api/public/users/{username}. Do not hardcode a random address unless the pay type is address.
Webhook never arrives URL must be public HTTPS. Signature header is X-Fidence-Signature in t=,v1= form. Localhost will not receive deliveries unless you tunnel. Use the test ping.
Can an agent pay a human checkout link? Yes. type: link after preflight.
Leaderboard is empty The payment must be a confirmed agent payment recorded through PayAgent, not only a raw explorer tx.
Solana or EVM? Both are valid. Default to Sepolia USDC unless the team already has a Solana stack.

Hour-1 goal: one recorded payment

Open a workspace, keep the policy on, and follow Docs v2. You sign the transaction. PayAgent verifies the hash.