Skip to main content
Guides are different from the Documentation tab. Documentation explains concepts and lists every parameter on every resource, the reference you keep open in a second tab. Guides are task-based: each one starts from nothing and ends with a working result, one goal, one path, start to finish. Follow a guide top to bottom in order. Where a concept deserves more depth than the guide has room for, it links out to the relevant Documentation page, come back and pick up where you left off.
Every guide runs in test mode by default: a full test environment with test money, so there’s nothing to verify and nothing to lose. See Test mode and live mode if you haven’t set that up yet.

​
Who these are for

Developers integrating AgentaOS into a real product, and merchants comfortable following a code block even if they don’t write code day to day. If you’re brand new to AgentaOS, start with the Quickstart first, it covers account setup in more depth than these guides assume.

​
Pick a guide

Accept your first payment

Create a payment link, share it, and confirm the money landed. The fastest path from zero to a paid checkout.

Sell a subscription

Create a recurring payment link, let a buyer subscribe at checkout, then list and cancel what’s running.

Go live

Move from test mode to real money: business verification, a payout account, and a live API key.

Handle webhooks

Register a URL, verify every signature, and fulfil an order the moment a checkout completes.

Let an AI agent run your store

Point a coding agent at the SKILL.md prompt, or connect the MCP server, and manage payments in plain language.

​
Next steps

Quickstart

New to AgentaOS? Start here before the guides above.

Payment SDK

Full reference for every resource and method in @agentaos/pay.