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

# Bem-vindo

> Integre Pix com a TroqPay e acompanhe tudo pelo seu backend.

## Cobre com Pix. Acompanhe pela API.

A TroqPay ajuda você a cobrar com Pix no Brasil, acompanhar o pagamento e o saldo pela API e solicitar saques em produção.

Seu cliente paga em `BRL` por Pix, seu sistema acompanha o checkout e o saldo — e quando quiser sacar, você usa o destino aprovado na sua conta e pode solicitar pelo app ou pela API.

<Info>
  Aqui você encontra o caminho completo para integrar a API da TroqPay:
  autenticação, checkouts Pix, saldo, saques, webhooks e produção.
</Info>

## O que você consegue fazer com a API

<CardGroup cols={2}>
  <Card title="Fazer seu primeiro checkout" icon="rocket" href="/quickstart">
    Crie uma cobrança Pix, exiba o QR Code e acompanhe o pagamento do início ao fim.
  </Card>

  <Card title="Usar o SDK JS" icon="code" href="/sdks/javascript">
    Integre checkouts, saldo e saques com o pacote TypeScript oficial.
  </Card>

  <Card title="Acompanhar saldo" icon="wallet" href="/flows/saldo">
    Leia o saldo da sua conta direto pela API, com todos os valores em decimal.
  </Card>

  <Card title="Solicitar saques" icon="wallet" href="/flows/saques">
    Solicite retirada para uma chave Pix ou carteira USDT em produção.
  </Card>

  <Card title="Configurar webhooks" icon="webhook" href="/flows/webhooks">
    Receba eventos em tempo real quando um checkout for pago ou expirar.
  </Card>
</CardGroup>

## Como o fluxo funciona

<CardGroup cols={4}>
  <Card title="1. Requisição">
    Seu backend cria o checkout e recebe os dados do Pix.
  </Card>

  <Card title="2. Pagamento">
    Seu cliente paga com QR Code, copia e cola ou checkout hospedado.
  </Card>

  <Card title="3. Webhook">
    A TroqPay envia um evento quando o checkout muda de estado.
  </Card>

  <Card title="4. Conciliação">
    Seu sistema usa `checkout.id`, `externalId` e `settlement` para fechar o fluxo.
  </Card>
</CardGroup>

## O que você encontra nesta documentação

<Steps>
  <Step title="Comece pelo onboarding">
    Use Introdução, Quickstart e Autenticação para sair do zero até sua primeira
    chamada funcionando.
  </Step>

  <Step title="Modele o checkout">
    Entenda o que salvar no seu sistema, o que mostrar ao comprador e como ler
    os estados da cobrança.
  </Step>

  <Step title="Trate webhooks com segurança">
    Aprenda a validar assinatura, responder rápido, lidar com reentregas e
    evitar processamento duplicado.
  </Step>

  <Step title="Revise o caminho para produção">
    Confira chaves, endpoints, logs e os sinais que valem a pena monitorar nas
    primeiras cobranças reais.
  </Step>
</Steps>

## Por onde começar

<CardGroup cols={3}>
  <Card title="Introdução" href="/introduction">
    Entenda o que a TroqPay resolve e como o checkout entra no seu fluxo.
  </Card>

  <Card title="Sandbox" href="/sandbox">
    Valide o fluxo completo sem misturar tráfego de teste com produção.
  </Card>

  <Card title="Saldo" href="/flows/saldo">
    Aprenda a ler o saldo da sua conta direto pela API.
  </Card>
</CardGroup>

## Precisa de ajuda para seguir?

<CardGroup cols={3}>
  <Card title="Faça o Quickstart" href="/quickstart">
    Se você quer validar rápido, esta é a melhor página para começar.
  </Card>

  <Card title="Revise os erros" href="/flows/errors">
    Veja como interpretar falhas, usar o `requestId` e decidir o próximo passo.
  </Card>

  <Card title="Abra o app" href="https://app.troqpay.com">
    Use o app da TroqPay para gerar chaves, revisar o ambiente e configurar sua conta.
  </Card>

  <Card title="Conectar agentes" href="/agents/claude-codex">
    Use o plugin MCP para Codex ou Claude operar checkouts com segurança.
  </Card>
</CardGroup>