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

# Visão geral dos Exemplos

> Exemplos executáveis e testáveis dos fluxos principais da Pagou v2, em várias linguagens, ligados ao guia e à referência da API.

O repositório [**PagouAi/examples**](https://github.com/PagouAi/examples) é um complemento prático e
executável desta documentação. Cada fluxo principal da v2 é implementado em sete linguagens usando um
cliente HTTP idiomático com o mínimo de dependências — **não** é um SDK e **não** é específico de
framework, então os mesmos padrões se aplicam a qualquer stack.

Cada guia aqui aponta para o diretório e o arquivo de exemplo exatos que o implementam, e cada exemplo
aponta de volta para o guia e a operação da referência da API. Use a documentação para entender um
fluxo e então vá direto para o código que você pode clonar e executar no sandbox.

## Navegue por fluxo

<CardGroup cols={2}>
  <Card title="Pagamentos" icon="wallet" href="/pt/examples/payments">
    Pix + QR, vouchers, cartão via Payment Element, 3DS, reembolsos totais e parciais, paginação.
  </Card>

  <Card title="Checkout Links" icon="link" href="/pt/examples/checkout-links">
    Crie um checkout link e guarde a URL pública retornada como identificador.
  </Card>

  <Card title="Clientes & Assinaturas" icon="repeat" href="/pt/examples/subscriptions">
    Crie ou reutilize um cliente e então crie, consulte e cancele uma assinatura.
  </Card>

  <Card title="Transferências (Pix Out)" icon="arrow-left-right" href="/pt/examples/transfers">
    Crie, consulte e reconcilie uma transferência; cancele quando o status permitir.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/pt/examples/webhooks">
    Handlers reais para as famílias de eventos de transação, assinatura e transferência.
  </Card>
</CardGroup>

## Linguagens

Todos os fluxos acima estão implementados em cada uma destas linguagens. Abra o diretório de uma
linguagem para ver seu `README.md`, o `.env.example` e os subdiretórios por fluxo.

| Linguagem         | Runtime (mín / atual) | Diretório                                                                 |
| ----------------- | --------------------- | ------------------------------------------------------------------------- |
| TypeScript / Node | 18.18 / 20.x          | [`typescript/`](https://github.com/PagouAi/examples/tree/main/typescript) |
| Python            | 3.10 / 3.14           | [`python/`](https://github.com/PagouAi/examples/tree/main/python)         |
| PHP               | 8.1 / 8.4             | [`php/`](https://github.com/PagouAi/examples/tree/main/php)               |
| Java              | 17 / 21               | [`java/`](https://github.com/PagouAi/examples/tree/main/java)             |
| C# / .NET         | 8.0 / 8.0             | [`dotnet/`](https://github.com/PagouAi/examples/tree/main/dotnet)         |
| Go                | 1.21 / 1.26           | [`go/`](https://github.com/PagouAi/examples/tree/main/go)                 |
| Ruby              | 3.2 / 3.3             | [`ruby/`](https://github.com/PagouAi/examples/tree/main/ruby)             |

A referência em TypeScript também traz uma variante `@pagouai/api-sdk` ao lado da variante raw-HTTP.

## Como executar

<Steps>
  <Step title="Obtenha um token de sandbox">
    Entre no seu painel e crie um token de API de **sandbox**. Tokens de sandbox e de produção são
    separados — mantenha-os assim.
  </Step>

  <Step title="Escolha uma linguagem e um fluxo">
    Abra o diretório da linguagem e leia o `README.md`, então abra o subdiretório do fluxo (por
    exemplo `typescript/payments/`).
  </Step>

  <Step title="Configure o ambiente">
    Copie `.env.example` para `.env` no diretório da linguagem e defina seu token de sandbox. A base
    URL usa `https://api.sandbox.pagou.ai` por padrão.
  </Step>

  <Step title="Execute um fluxo">
    Cada README de fluxo documenta um único comando de execução, o payload de entrada, a resposta
    relevante e o caminho de erro e recuperação esperado.
  </Step>
</Steps>

## Cobertura e segurança

* A [matriz de cobertura](https://github.com/PagouAi/examples/blob/main/docs/coverage-matrix.md) é a
  fonte única da verdade sobre o que cada linguagem implementa.
* Nenhum exemplo recebe PAN ou CVV no backend — os dados de cartão passam apenas pelo
  [Payment Element](/pt/frontend/payment-element/overview) para um token `pgct_*`. As chaves de API são
  usadas somente no servidor, os fixtures são sintéticos e os logs ocultam segredos.

<Note>
  O repositório está em **beta** enquanto a área de Exemplos entra no ar e os times donos são
  atribuídos. Os fluxos em si já estão completos, testados e executáveis hoje.
</Note>