Move from test mode to real money: verify your business, add a payout account, and swap your test key for a live one.
By the end of this guide your account is verified, has somewhere to send money, and is running on a live API key instead of a test one. Test mode and live are fully separate environments in AgentaOS, nothing you built carries over automatically, only your code does, so this is a short, deliberate switch, not a background setting.
You’ve already tested your integration end to end in test mode: checkout creation, webhook delivery, and (if you’re selling recurring plans) subscription creation. See Accept your first payment and Sell a subscription if you haven’t.
Your real business details on hand: legal name, address, and whatever your business verification asks for.
1
Finish testing in test mode
Confirm the basics work with test data before you touch real money: a checkout completes, your webhook handler verifies the signature and fulfills correctly, and (if relevant) a subscription activates and cancels the way you expect. Test mode is free and has no verification gate, so there’s no reason to skip this.
2
Open Go live in the dashboard
The sidebar’s Go live item is your durable readiness tracker, with a progress chip showing what’s left. It stays visible until every step below is done, and it’s the fastest way to see what’s blocking you.
The Go live tracker.
3
Complete business verification (KYB)
AgentaOS is the Merchant of Record on every live transaction, we need to know who we’re selling on behalf of before real money moves. Submit your business details for review from the Go live page.
See Account review for what we check and how to prepare. Reviews are usually completed within a day.
4
Add a payout account
You need somewhere for your balance to go. Set up bank, wallet, or both.
Bank account
Wallet
Add a bank account to receive payouts in EUR or USD across the supported countries. See Supported countries.
Have a wallet address you control ready to receive stablecoin payouts. No separate institution or verification is required for this path, since you’re moving your own balance to your own address.
See Payouts for how your balance moves through Incoming, Available, and In reserve before it pays out.
5
Switch to Live and generate a live key
Once verification is approved, flip the Test/Live switch at the top of the dashboard sidebar to Live, then generate a new key from Settings → Developers → API Keys. Live keys are prefixed sk_live_.
const agentaos = new AgentaOS(process.env.AGENTAOS_API_KEY!); // now sk_live_...
The SDK detects the environment from the key’s prefix automatically, there’s no separate flag to flip. Swap the environment variable in your deploy, and every call now reads and writes live data.
6
Point production URLs at production
Update successUrl, cancelUrl, and webhookUrl on your live checkouts and payment links to your real domain, not localhost or a tunnel URL left over from testing. Then check Developer → Webhooks while the dashboard is switched to Live, and confirm your production endpoint and signing secret are set. See Handle webhooks if you haven’t wired this up yet.
The Go live progress chip in the sidebar shows every step complete.
Settings → Developers → API Keys shows an active sk_live_ key, and your server is using it.
Your payout destination (bank IBAN or wallet address) appears on the Payouts page.
Optionally, run one small real checkout end to end: create it with your live key, pay it with a real card, and confirm it lands in Finance → Payments with an invoice under Finance → Invoices. Unlike test mode, live mode doesn’t accept the 4242... test card, only real payment methods clear.
