Bags DocsAgentic Commerce — instant onboarding
Sign up for live x402 in minutes — no business KYB, live API keys, and payout verification at withdrawal.
BAGS Agent is the agentic commerce product on getbags.app (alias agent.getbags.app). Solo developers metering an API for AI agents can go live on mainnet x402 in minutes without a business KYB application. Funds accumulate in BAGS-managed CDP intake wallets; payouts require a one-time lightweight verification before money leaves the treasury.
For x402 setup after onboarding, see Sell to agents.
What you get
| Capability | Agentic accounts |
|---|---|
| Live x402 proxy links | Immediately at signup |
| Business KYB form | Not required |
| Custodial intake wallet | Provisioned at signup |
| Live API keys | Mint from Settings → API keys (agentic-scoped) |
| Payouts | After lightweight verification + sanctions screen |
Payments never stop when you cross the pre-verification accumulation soft cap — the buyer-facing x402 endpoint stays reliable. The hard control is at the exit: unverified accounts cannot withdraw.
Signup flow
- Visit getbags.app (or agent.getbags.app) and open Get started.
- Sign in with email (magic link or Google).
- Accept the agentic Terms of Service — the UI calls
POST /api/agentic/onboard. - BAGS provisions your merchant row (
account_mode = 'agentic'), CDP intake wallets, and you can create agentic proxy payment links immediately.
Soft cap and payout verification
Pre-verification soft cap ($1,000)
Unverified merchants have a soft cap on gross collections (default $1,000 USD, configurable as AGENTIC_SOFT_CAP_USD). Crossing the cap:
- Does not block x402 payments or link creation.
- Triggers a dashboard banner and a one-shot nudge email prompting verification.
Check status with GET /api/merchant/agentic-cap (dashboard session auth).
Payout verification (verify at withdrawal)
Before your first payout, submit a lightweight individual check — not a business KYB form:
- Full name
- Country (ISO 3166-1 alpha-2)
- Payout wallet address and network
BAGS runs a sanctions/OFAC screen. Clear screenings mark you verified; flagged screenings enter pending_review. Until payout_verification_status = 'verified', live payouts are blocked.
Live API keys
Mint keys from Account Settings → API keys (/dashboard/settings). Agentic merchants get live keys without business KYB; those keys are minted with scope = 'agentic' and work only on agentic surfaces:
| Method | Path |
|---|---|
GET/POST | /api/v1/payment-links |
GET/PATCH/DELETE | /api/v1/payment-links/{id} |
GET | /api/v1/transactions |
GET | /api/merchant/proxy-signing-secret |
Endpoints from the sunset checkout product (checkout sessions, refunds, settlements, and product CRUD via API key) reject agentic-scoped keys. Prefer /api/v1/*. See Authentication, /auth.md, and OpenAPI.
API: instant onboarding
Dashboard session auth (Supabase JWT via cookie or Authorization: Bearer <access_token>).
GET /api/agentic/onboard
Returns whether the signed-in user already has a merchant row.
POST /api/agentic/onboard
{
"acceptTerms": true,
"displayName": "optional display name",
"country": "US"
}| Field | Required | Description |
|---|---|---|
acceptTerms | Yes | Must be true |
displayName | No | Defaults to email local-part |
country | No | ISO 3166-1 alpha-2; defaults to "unknown" |
Creates an agentic-tier merchant and provisions intake wallets.
API: payout verification
Dashboard session auth. Only for account_mode = 'agentic'.
GET /api/agentic/verification
Returns payoutVerificationStatus: unverified | pending_review | verified | failed.
POST /api/agentic/verification
{
"fullName": "Jane Developer",
"country": "US",
"payoutWalletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"payoutNetwork": "base"
}screeningResult is clear (auto-verified) or flagged (pending_review).
Related
- Provider quickstart — create links and publish your x402 URL
- Payouts — withdrawal mechanics
- Agents & MCP — MCP,
/auth.md, discovery