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

# Integration guides

> Task-oriented walkthroughs of the most common Portão 3 integration flows

These guides walk through the workflows integrators build most often on top of the Portão 3 APIs. Each one explains the end-to-end flow, shows the requests in order, and links to the exact endpoints in the [API Reference](/api-reference/overview).

If you haven't authenticated yet, start with the [Quickstart](/quickstart) — every flow below assumes you already have an `accessToken`.

## Before you begin

A few conventions apply to every Banking flow in these guides:

* **Base URL** — Banking lives at `https://api.banking.v2.portao3.com.br`.
* **Tenancy** — most paths are scoped to your `realmId`, `organizationId`, `accountId`, and a `walletId`. You receive these during onboarding. Replace the `{...}` placeholders with your values.
* **Environment header** — Banking requests carry an `x-environment` header: `LIVE` for production money movement, `TEST` for sandbox data.
* **Amounts are in centavos** — an `amount` of `10000` means R\$ 100,00.
* **Authorization** — send your token as `Authorization: Bearer <accessToken>` on every call.

<Note>
  Some sensitive operations (confirming a payment, reading full card details) may additionally require the authenticated user's transaction `pin` header, depending on how your credentials are provisioned. See [Authentication](/#authentication) for details.
</Note>

## Choose a flow

<CardGroup cols={2}>
  <Card title="Issue virtual cards" icon="credit-card" href="/guides/issue-virtual-cards">
    Create a virtual card, read its PAN and CVV, and hand it to a merchant for a charge.
  </Card>

  <Card title="Control card spending" icon="sliders" href="/guides/card-spending-controls">
    Attach spend limits and merchant-category rules to cards, and check available balance.
  </Card>

  <Card title="Manage and monitor cards" icon="list" href="/guides/manage-cards">
    List cards, block and unblock them, and read their transaction history.
  </Card>

  <Card title="Send a PIX payment" icon="arrow-up-right" href="/guides/send-pix">
    Pay out by PIX key or QR Code with the initiate-then-confirm flow.
  </Card>

  <Card title="Charge with PIX" icon="qrcode" href="/guides/collect-pix">
    Generate a PIX QR Code (Copia e Cola) and get notified when it's paid.
  </Card>

  <Card title="Recurring billing with Pix Automático" icon="repeat" href="/guides/pix-automatico">
    Set up an authorized recurring debit, track each cycle, and fall back to boleto.
  </Card>

  <Card title="Wallets for your customers" icon="wallet" href="/guides/wallets">
    Open a wallet per end customer, register PIX keys, read balances, and move money between wallets.
  </Card>

  <Card title="Receive webhooks" icon="bell" href="/guides/webhooks">
    Understand the notification envelope and the events that drive every async flow.
  </Card>
</CardGroup>