merchant_id and
API secret, and verify signed payment receipts statelessly on your own
server. No bridge to deploy, no services.json entry to file.
Non-custodial
You set your own payout wallet on Polygon. Settlement lands there
directly — AiFinPay never takes custody of your funds.
Stateless verification
Receipts are signed JWTs. Verify them against AiFinPay’s public JWKS —
no shared secret required on the verification path.
Looking for the bridge / marketplace-registry path instead? That’s for
providers who want their API auto-discoverable in the AiFinPay registry
— see Become a provider.
1
Create an account
Go to dash.aifinpay.io and sign up with an
email and password. You’re signed in immediately — a verification
email is also sent, but it doesn’t block you from continuing. The same
account manages your AI agents (if you have any) at
/me.2
Create your first service
In the dashboard, create a service with:
- A service name — how agents and the dashboard identify it.
- A payout wallet — a public
0x…address on Polygon. Settlement lands here non-custodially; AiFinPay never holds your funds.
3
Integrate the paywall in your API
An agent gets a quote for the resource it wants, pays on-chain, and
presents a signed receipt. You verify that receipt statelessly — no
call back to AiFinPay needed on the request’s hot path.1. The agent requests a quote:2. The agent pays on-chain and sends your API the resulting signed
receipt. Verify it with your merchant’s JWKS keyset:
Verification only needs the public JWKS — your
msec_… secret is
never involved in checking a receipt. Keep the secret for
dashboard/API authentication only.4
Manage everything from the dashboard
Once your service is live, the dashboard is where you run it day to
day:
Pricing
Set a unit price per tier (e.g.
standard, premium) — this is
what quotes are generated against.Webhook
Add a settlement webhook URL. AiFinPay sends an HMAC-signed
POST
on every settlement so you can react in real time instead of
polling.Settings
Rotate your secret if it’s ever exposed. The old secret is
invalidated immediately; the previous value can’t be re-viewed.
Receipts & activity
Watch receipts, usage stats, and live activity as agents pay —
useful for reconciling against your own metering.
The dashboard’s per-merchant management views (pricing, webhook config,
secret rotation, receipts) are part of the dashboard UI itself, not a
public API endpoint you call directly from your backend. Your backend
only needs
POST /v1/quote and the JWKS endpoint above.What you get
No bridge to run
Skip standing up and hosting a separate x402 bridge process — the
quote + receipt flow talks directly to your existing API.
No registry entry to file
You don’t need a
services.json PR or a redeploy to start
charging — create a service in the dashboard and you’re live.Protocol credits, not tokens
Agents may also earn mSECCO — non-transferable protocol credits —
on paid calls. There’s nothing for you or the agent to buy, hold, or
trade.
Real-time visibility
Receipts, stats, and live activity in one place, without building
your own on-chain indexer.
Next steps
Become a provider (bridge path)
Want your API auto-discoverable in the AiFinPay registry too? See the
config-only bridge path.
Networks reference
Live contract addresses and network details for the settlement side of
a payment.