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

# Produção

> Use este checklist antes de subir tráfego real para a TroqPay.

# Produção

Quando sua integração estiver pronta, o próximo passo é trocar a chave de teste por uma `trq_live_` e preparar o ambiente para receber cobranças reais.

Produção não é só trocar segredo.

É garantir que checkout, webhook e conciliação continuam funcionando quando o pagamento deixa de ser simulado.

## Antes de usar com clientes reais

<Steps>
  <Step title="Gerar a chave de produção">
    Crie uma credencial exclusiva para o ambiente real e armazene-a no seu gerenciador de segredos.
  </Step>

  <Step title="Configurar o webhook definitivo">
    Cadastre a URL final do seu endpoint, valide a assinatura e confirme que seus logs conseguem separar produção de teste.
  </Step>

  <Step title="Confirmar a configuração da conta">
    Verifique no app se a sua conta está marcada como `APPROVED` para produção. Sem isso, chamadas com `trq_live_` retornam `403 forbidden`.
  </Step>

  <Step title="Começar com poucas cobranças">
    Faça as primeiras cobranças reais com volume baixo e valide o fluxo do início ao fim.
  </Step>
</Steps>

## Estados de aprovação

Sua conta passa por estes quatro estados antes de poder cobrar com `trq_live_`:

| Estado           | O que significa                           |
| ---------------- | ----------------------------------------- |
| `NOT_REQUESTED`  | Você ainda não pediu acesso à produção    |
| `PENDING_REVIEW` | Você pediu; a TroqPay está revisando      |
| `APPROVED`       | Você está liberado para usar `trq_live_`  |
| `REJECTED`       | Pedido rejeitado; o motivo aparece no app |

Você só pode subir tráfego real a partir de `APPROVED`.

## Readiness da conta

<CardGroup cols={2}>
  <Card title="Chave correta">
    Seu backend precisa estar usando `trq_live_` apenas no ambiente real, sem compartilhar segredo com sandbox.
  </Card>

  <Card title="Endpoint público">
    Seu webhook precisa estar acessível por HTTPS e pronto para responder `2xx` rápido.
  </Card>

  <Card title="Conta aprovada">
    Sua conta precisa estar marcada como `APPROVED` para produção. Cheque o estado no app antes de trocar a chave.
  </Card>

  <Card title="Logs úteis">
    Tenha `checkout.id`, `externalId`, `event.id`, `requestId` e `livemode` visíveis para investigação.
  </Card>
</CardGroup>

## O que muda do sandbox para a produção

| Item                    | Teste             | Produção        |
| ----------------------- | ----------------- | --------------- |
| Prefixo da chave        | `trq_test_`       | `trq_live_`     |
| `livemode`              | `false`           | `true`          |
| Movimentação financeira | Simulada          | Real            |
| Uso recomendado         | Validação técnica | Cobranças reais |

## O que vale monitorar nas primeiras cobranças

* checkout criado sem duplicidade
* comprador conseguindo abrir e pagar o Pix
* webhook chegando e recebendo `2xx`
* seu sistema processando `checkout.paid` só uma vez
* logs com `requestId`, `checkout.id` e `externalId` disponíveis

## Boas práticas para o ambiente real

* registre `checkout.id`, `externalId` e `requestId`
* trate retries com idempotência
* monitore falhas de webhook e tempo de processamento
* mantenha teste e produção separados nos seus logs

<Warning>
  Nunca reutilize a mesma chave entre ambientes e nunca trate produção como extensão do sandbox.
</Warning>

## Quando você está pronto para ampliar o uso

<Card title="Sinal verde para avançar" horizontal>
  Você está pronto para aumentar o volume quando seu time já consegue criar cobranças, processar `checkout.paid`, investigar falhas pelos logs e reconciliar cada checkout com segurança.
</Card>

## Próximos passos

<CardGroup cols={3}>
  <Card title="Webhooks" href="/flows/webhooks">
    Revise assinatura, reentregas e como responder o endpoint em produção.
  </Card>

  <Card title="Erros" href="/flows/errors">
    Entenda o que fazer se uma chamada falhar ou um webhook não puder ser processado.
  </Card>

  <Card title="Boas práticas" href="/flows/boas-praticas-checkout">
    Use um checklist simples para manter checkout, logs e reconciliação em ordem.
  </Card>
</CardGroup>

## Precisa de ajuda para seguir?

<CardGroup cols={3}>
  <Card title="Voltar ao sandbox" href="/sandbox">
    Se ainda faltar uma validação, volte ao ambiente de teste antes de subir mais tráfego real.
  </Card>

  <Card title="Revisar autenticação" href="/authentication">
    Confira chaves, ambiente e idempotência antes de trocar segredos no backend.
  </Card>

  <Card title="Abrir o app" href="https://app.troqpay.com">
    Revise chaves, ambiente e configuração da conta direto no app da TroqPay.
  </Card>
</CardGroup>