> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentaos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guides

> Task-based, end-to-end walkthroughs. Pick the outcome you want and follow the steps to get there.

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.

<Info>
  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](/getting-started/test-mode) if you haven't set that up yet.
</Info>

## 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](/getting-started/quickstart) first, it covers account setup in more depth than these guides assume.

## Pick a guide

<CardGroup cols={2}>
  <Card title="Accept your first payment" icon="credit-card" href="/guides/accept-your-first-payment">
    Create a payment link, share it, and confirm the money landed. The fastest path from zero to a paid checkout.
  </Card>

  <Card title="Sell a subscription" icon="rotate" href="/guides/sell-a-subscription">
    Create a recurring payment link, let a buyer subscribe at checkout, then list and cancel what's running.
  </Card>

  <Card title="Go live" icon="rocket" href="/guides/go-live">
    Move from test mode to real money: business verification, a payout account, and a live API key.
  </Card>

  <Card title="Handle webhooks" icon="bell" href="/guides/handle-webhooks">
    Register a URL, verify every signature, and fulfil an order the moment a checkout completes.
  </Card>

  <Card title="Let an AI agent run your store" icon="robot" href="/guides/ai-agent">
    Point a coding agent at the SKILL.md prompt, or connect the MCP server, and manage payments in plain language.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/getting-started/quickstart">
    New to AgentaOS? Start here before the guides above.
  </Card>

  <Card title="Payment SDK" icon="code" href="/sdk/pay-overview">
    Full reference for every resource and method in `@agentaos/pay`.
  </Card>
</CardGroup>