> ## Documentation Index
> Fetch the complete documentation index at: https://developers.portao3.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Guias de integração

> Passo a passo orientado a tarefas dos fluxos de integração mais comuns do Portão 3

Estes guias percorrem os fluxos de trabalho que os integradores constroem com mais frequência sobre as APIs do Portão 3. Cada um explica o fluxo de ponta a ponta, mostra as requisições em ordem e faz link para os endpoints exatos na [Referência da API](/api-reference/overview).

Se você ainda não se autenticou, comece pelo [Guia rápido](/quickstart) — todos os fluxos abaixo pressupõem que você já possui um `accessToken`.

## Antes de começar

Algumas convenções se aplicam a todos os fluxos de Banking nestes guias:

* **URL base** — o Banking fica em `https://api.banking.v2.portao3.com.br`.
* **Tenancy** — a maioria dos caminhos é escopada por `realmId`, `organizationId`, `accountId` e um `walletId`. Você recebe esses valores durante o onboarding. Substitua os placeholders `{...}` pelos seus valores.
* **Header de ambiente** — as requisições de Banking carregam um header `x-environment`: `LIVE` para movimentação de dinheiro em produção, `TEST` para dados de sandbox.
* **Os valores são em centavos** — um `amount` de `10000` significa R\$ 100,00.
* **Autorização** — envie seu token como `Authorization: Bearer <accessToken>` em cada chamada.

<Note>
  Algumas operações sensíveis (confirmar um pagamento, ler os detalhes completos de um cartão) podem adicionalmente exigir o header `pin` da transação do usuário autenticado, dependendo de como suas credenciais foram provisionadas. Veja [Autenticação](/#authentication) para detalhes.
</Note>

## Escolha um fluxo

<CardGroup cols={2}>
  <Card title="Emitir cartões virtuais" icon="credit-card" href="/guides/issue-virtual-cards">
    Crie um cartão virtual, leia seu PAN e CVV e entregue-o a um estabelecimento para uma cobrança.
  </Card>

  <Card title="Controlar gastos do cartão" icon="sliders" href="/guides/card-spending-controls">
    Anexe limites de gasto e regras de categoria de estabelecimento aos cartões e consulte o saldo disponível.
  </Card>

  <Card title="Gerenciar e monitorar cartões" icon="list" href="/guides/manage-cards">
    Liste cartões, bloqueie e desbloqueie e leia seu histórico de transações.
  </Card>

  <Card title="Enviar um pagamento PIX" icon="arrow-up-right" href="/guides/send-pix">
    Pague por chave PIX ou QR Code com o fluxo de iniciar-e-confirmar.
  </Card>

  <Card title="Cobrar com PIX" icon="qrcode" href="/guides/collect-pix">
    Gere um QR Code PIX (Copia e Cola) e seja notificado quando for pago.
  </Card>

  <Card title="Cobrança recorrente com Pix Automático" icon="repeat" href="/guides/pix-automatico">
    Configure um débito recorrente autorizado, acompanhe cada ciclo e utilize o boleto como fallback.
  </Card>

  <Card title="Carteiras para seus clientes" icon="wallet" href="/guides/wallets">
    Abra uma carteira por cliente final, registre chaves PIX, leia saldos e movimente dinheiro entre carteiras.
  </Card>

  <Card title="Receber webhooks" icon="bell" href="/guides/webhooks">
    Entenda o envelope de notificação e os eventos que dirigem cada fluxo assíncrono.
  </Card>
</CardGroup>