> ## 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.

# Documentação para Desenvolvedores da Pagou

> Integre Pix, voucher, cartão, assinaturas, transferências, webhooks e fluxos de cartão no front-end com uma jornada centrada na v2.

<CardGroup cols={2}>
  <Card title="Comece em sandbox" icon="rocket" href="/pt/start-here/quickstart">
    Crie uma primeira transação v2 com o mínimo de configuração e avance para fluxos seguros de produção.
  </Card>

  <Card title="Use com agentes de IA" icon="bot" href="/pt/start-here/ai-integration">
    Dê a Claude Code, Cursor, Codex, Copilot, Windsurf, Lovable, Bolt.new ou v0 o contexto certo da Pagou.
  </Card>
</CardGroup>

## Caminhos principais de integração

<CardGroup cols={3}>
  <Card title="Pagamentos" icon="wallet" href="/pt/payments/overview">
    Modele clientes, transações, Pix, voucher, cartão, reembolsos e tratamento de status de transação.
  </Card>

  <Card title="Payment Element" icon="credit-card" href="/pt/frontend/payment-element/overview">
    Monte campos de cartão hospedados, dispare tokenização, trate 3D Secure e mantenha segredos no back-end.
  </Card>

  <Card title="Assinaturas" icon="repeat" href="/pt/subscriptions/overview">
    Crie cobrança recorrente com clientes, renovações, retentativas e webhooks de assinatura.
  </Card>

  <Card title="Pix Out" icon="arrow-left-right" href="/pt/payouts/pix-out/overview">
    Crie transferências Pix de saída, cancele transferências pendentes e reconcilie o estado do payout.
  </Card>
</CardGroup>

## Construa por tarefa

<CardGroup cols={2}>
  <Card title="Receber Pix" icon="qr-code" href="/pt/payments/pix/accept-payments">
    Crie transações Pix, devolva os dados do QR code ao comprador e finalize por webhook ou reconciliação.
  </Card>

  <Card title="Receber vouchers" icon="ticket" href="/pt/payments/vouchers/accept-payments">
    Crie instruções locais como Boleto, SPEI, Mercado Pago, Webpay, CODI ou PSE usando `method: "voucher"`.
  </Card>

  <Card title="Receber cartão" icon="panel-top" href="/pt/frontend/payment-element/accept-a-payment">
    Use `elements.submit(...)` para tokenizar cartões e envie o token para a rota de criação de transação no back-end.
  </Card>

  <Card title="Cobrar assinaturas" icon="repeat" href="/pt/subscriptions/create">
    Inicie cobrança recorrente com um cliente, um token de cartão e a API de assinaturas.
  </Card>

  <Card title="Receber webhooks" icon="webhook" href="/pt/webhooks/overview">
    Construa uma entrada única para eventos de pagamento, assinatura e payout com deduplicação por ID de evento.
  </Card>

  <Card title="Entrar em produção" icon="list-checks" href="/pt/start-here/go-live-checklist">
    Confirme ambiente, autenticação, idempotência, webhook, retentativas e reconciliação antes da produção.
  </Card>
</CardGroup>

## Referência e ferramentas

<CardGroup cols={3}>
  <Card title="Referência API" icon="file-code-2" href="/pt/api-reference/transactions/reference">
    Navegue por clientes, transações, assinaturas, transferências v2 e endpoints legados v1 por recurso.
  </Card>

  <Card title="SDK TypeScript" icon="code-xml" href="/pt/sdks/typescript/quickstart">
    Configure o SDK oficial server-side para TypeScript em pagamentos e transferências.
  </Card>

  <Card title="OpenAPI v2" icon="braces" href="/api-reference/openapi-v2.json">
    Use a fonte de verdade de schemas para builders de request, testes, mocks e validação por agentes.
  </Card>
</CardGroup>

## Regras de produção

* Crie pagamentos e transferências apenas pelo back-end.
* Use `external_ref` como identificador estável de escrita.
* Nunca invente campos que não existem no schema OpenAPI.
* Use Payment Element e `elements.submit(...)` para tokenização de cartão.
* Libere pedidos apenas a partir de webhook confirmado ou estado reconciliado.
* Deduplique webhooks pelo `id` do evento no topo.

## Leia a seguir

* [Visão geral](/pt/start-here/overview)
* [Autenticação](/pt/start-here/authentication)
* [Erros e retentativas](/pt/start-here/errors-and-retries)
* [Atualizações](/pt/changelog)