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

# Comece aqui

> Guia inicial para sair do zero e colocar sua integracao TurbofyPay em producao com previsibilidade.

<div className="turbofy-hero">
  <span className="turbofy-eyebrow">Bem-vindo</span>
  <h1>Integre a API TurbofyPay com clareza desde a primeira chamada</h1>

  <p className="turbofy-lead">
    Esta documentacao foi escrita para uso real de integrador: menos friccao,
    contratos claros e fluxo direto para sair de teste e entrar em producao.
  </p>

  <div className="turbofy-hero-actions">
    <a href="/integracao/autenticacao">Configurar autenticacao</a>
    <a href="/reference/cobranca-pix/criar-cobranca-pix">Criar primeira cobranca PIX</a>
  </div>
</div>

## O que voce resolve com a TurbofyPay

<div className="turbofy-grid">
  <div className="turbofy-card">
    <h3>Cobranca PIX</h3>
    <p>Crie cobrancas com QR Code e copia e cola para checkout rapido.</p>
  </div>

  <div className="turbofy-card">
    <h3>Payouts</h3>
    <p>Envie pagamentos em lote com assinatura HMAC e trilha auditavel.</p>
  </div>

  <div className="turbofy-card">
    <h3>Webhooks</h3>
    <p>Receba eventos de ciclo de vida sem depender de polling constante.</p>
  </div>
</div>

## Comece em 3 passos

1. Configure credenciais em [Autenticacao](/integracao/autenticacao).
2. Emita uma cobranca em [Criar cobranca PIX](/reference/cobranca-pix/criar-cobranca-pix).
3. Feche o ciclo assincrono em [Webhooks](/integracao/webhooks).

<img src="https://mintcdn.com/turbofypay/PV8PQGFRC5_DV7l4/images/enterprise/journey-credentials-pix-webhook-production.png?fit=max&auto=format&n=PV8PQGFRC5_DV7l4&q=85&s=c6014035fa9ec8494f5a7d56db73a291" alt="Jornada de integracao da TurbofyPay em quatro etapas: credenciais, cobranca PIX, webhook e producao." width="1586" height="992" data-path="images/enterprise/journey-credentials-pix-webhook-production.png" />

*Visao operacional da jornada recomendada: autenticar, emitir o primeiro PIX, receber eventos assincronos e validar criterios de producao.*

## Quickstart (5 minutos)

1. Copie `x-client-id` e `x-client-secret` no painel TurbofyPay.
2. Envie `POST /sellers/pix` com um `x-idempotency-key` unico.
3. Salve o `id` retornado para conciliacao.
4. Configure seu endpoint de callback em [Webhooks](/integracao/webhooks).
5. Confirme o ciclo completo: cobranca criada, evento recebido e status atualizado.

## Exemplo rapido

```bash theme={null}
curl --request POST \
  --url https://api.turbofypay.com/sellers/pix \
  --header "x-client-id: <client-id>" \
  --header "x-client-secret: <client-secret>" \
  --header "x-idempotency-key: pedido-123" \
  --header "Content-Type: application/json" \
  --data '{
    "amountCents": 2990,
    "description": "Pedido #123",
    "externalRef": "pedido-123"
  }'
```

## Como esta docs foi desenhada

* **Direta ao ponto:** cada endpoint responde rapidamente o que enviar e o que esperar.
* **Consistente:** headers, erros e exemplos seguem um mesmo padrao operacional.
* **Auditavel:** orientacoes de idempotencia, assinatura e observabilidade estao no fluxo principal.

## Jornada ideal de integracao

| Etapa              | O que voce quer sentir  | O que esta docs entrega                                  |
| ------------------ | ----------------------- | -------------------------------------------------------- |
| Descoberta         | "isso parece confiavel" | Introducao clara, branding limpo e exemplo funcional.    |
| Integracao inicial | "sei por onde comecar"  | Quickstart de 5 minutos e autenticacao objetiva.         |
| Primeira execucao  | "deu certo"             | Resposta explicada, codigos de status e proximos passos. |
| Escala/operacao    | "consigo manter isso"   | Webhooks, checklist de producao e troubleshooting.       |

## Proximo passo recomendado

Siga para [Autenticacao](/integracao/autenticacao), valide uma requisicao real e depois avance para a aba **API Reference** para detalhes por endpoint.