Skip to main content
Test mode lets you build and test your AgentaOS integration in a completely isolated environment. Payments, webhooks, customers, and invoices are kept separate from live, so you can develop with confidence and never risk a real charge.
Always build and test in test mode first. Every new account starts there, so there is nothing to switch on.

​
Test and live are chosen by your key

AgentaOS has one base URL. The key prefix decides which environment you hit, so you never point at the wrong host.
Find both keys under Settings → Developers → API Keys. Store them as environment variables and never commit them.
.env

​
Testing payments

Test-mode checkouts render the secure card form. Use these test cards with any future expiry and any CVC:
Only type a card number into the checkout page (the secure card form). Never send a card number to any API, in test mode or live.

​
Testing webhooks

In test mode, events go to the webhook URL you register in Settings → Developers → Webhooks. To receive them on your machine, expose your local server with a tunnel like ngrok and register the tunnel URL. This lets you verify signature validation and your event handlers before going live. See Webhooks.

​
Going live

1

Finish testing in test mode

Run your full flow with the test cards above, including a webhook round-trip, until every path behaves.
2

Verify your business

Complete business verification (KYB) in the dashboard. This is required before you can accept real money as Merchant of Record.
3

Add a payout account

Add a bank account or wallet so your earnings have somewhere to settle. See Payouts.
4

Swap to your live key

Replace sk_test_ with sk_live_ in your environment variables. Nothing else changes.
5

Register your live webhook

Add your production webhook URL and copy its live signing secret.
6

Watch your first payments

Keep an eye on your first live transactions to confirm everything behaves as it did in test mode.
Never use a sk_test_ key in production. Test-key calls never touch live money and will not settle.

​
Next steps

Checkouts

Create checkout sessions and payment links.

Go live guide

The full test-to-production checklist.

Subscriptions

Recurring billing and cancellation.

Webhooks

Receive and verify real-time events.