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

# Pagou Developer Docs

> Integrate Pix, voucher, card payments, subscriptions, payouts, webhooks, and frontend card flows with a v2-first developer journey.

<CardGroup cols={2}>
  <Card title="Start in sandbox" icon="rocket" href="/start-here/quickstart">
    Create a first v2 transaction with the minimum setup, then expand into production-safe flows.
  </Card>

  <Card title="Use with AI agents" icon="bot" href="/start-here/ai-integration">
    Give Claude Code, Cursor, Codex, Copilot, Windsurf, Lovable, Bolt.new, or v0 the right Pagou context.
  </Card>
</CardGroup>

## Core integration paths

<CardGroup cols={3}>
  <Card title="Payments" icon="wallet" href="/payments/overview">
    Model customers, transactions, Pix, vouchers, cards, refunds, and transaction status handling.
  </Card>

  <Card title="Payment Element" icon="credit-card" href="/frontend/payment-element/overview">
    Mount hosted card fields, trigger tokenization, handle 3D Secure, and keep secrets on your backend.
  </Card>

  <Card title="Subscriptions" icon="repeat" href="/subscriptions/overview">
    Create recurring card billing with customers, renewals, retries, and subscription webhooks.
  </Card>

  <Card title="Pix Out" icon="arrow-left-right" href="/payouts/pix-out/overview">
    Create outbound Pix transfers, cancel pending transfers, and reconcile payout state.
  </Card>
</CardGroup>

## Build by job

<CardGroup cols={2}>
  <Card title="Accept Pix" icon="qr-code" href="/payments/pix/accept-payments">
    Create Pix transactions, return QR code data to the buyer, and finalize from webhook or reconciliation state.
  </Card>

  <Card title="Accept vouchers" icon="ticket" href="/payments/vouchers/accept-payments">
    Create local payment instructions such as Boleto, SPEI, Mercado Pago, Webpay, CODI, or PSE through `method: "voucher"`.
  </Card>

  <Card title="Accept cards" icon="panel-top" href="/frontend/payment-element/accept-a-payment">
    Use `elements.submit(...)` to tokenize cards and pass the token to your backend transaction create route.
  </Card>

  <Card title="Bill subscriptions" icon="repeat" href="/subscriptions/create">
    Start recurring billing with a customer, a card token, and the Subscriptions API.
  </Card>

  <Card title="Receive webhooks" icon="webhook" href="/webhooks/overview">
    Build one ingestion path for payment, subscription, and payout events with event ID deduplication.
  </Card>

  <Card title="Go live" icon="list-checks" href="/start-here/go-live-checklist">
    Confirm environment, auth, idempotency, webhook, retry, and reconciliation behavior before production.
  </Card>
</CardGroup>

## Reference and tools

<CardGroup cols={3}>
  <Card title="API Reference" icon="file-code-2" href="/api-reference/transactions/reference">
    Browse v2 customers, transactions, subscriptions, transfers, and legacy v1 endpoints by resource.
  </Card>

  <Card title="TypeScript SDK" icon="code-xml" href="/sdks/typescript/quickstart">
    Configure the official server-side TypeScript SDK for payments and transfers.
  </Card>

  <Card title="OpenAPI v2" icon="braces" href="/api-reference/openapi-v2.json">
    Use the schema source of truth for request builders, tests, mocks, and agent validation.
  </Card>
</CardGroup>

## Production rules

* Create payments and transfers only from your backend.
* Use `external_ref` as your stable write identifier.
* Never invent fields that are not present in the OpenAPI schema.
* Use Payment Element and `elements.submit(...)` for card tokenization.
* Fulfill orders only from webhook-confirmed or reconciled state.
* Deduplicate webhooks by the top-level event `id`.

## Read next

* [Overview](/start-here/overview)
* [Authentication](/start-here/authentication)
* [Errors and Retries](/start-here/errors-and-retries)
* [Changelog](/changelog)