Skip to main content

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

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

1

Gerar a chave de produção

Crie uma credencial exclusiva para o ambiente real e armazene-a no seu gerenciador de segredos.
2

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

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

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.

​
Estados de aprovação

Sua conta passa por estes quatro estados antes de poder cobrar com trq_live_:
EstadoO que significa
NOT_REQUESTEDVocê ainda não pediu acesso à produção
PENDING_REVIEWVocê pediu; a troqpay está revisando
APPROVEDVocê está liberado para usar trq_live_
REJECTEDPedido rejeitado; o motivo aparece no app
Você só pode subir tráfego real a partir de APPROVED.

​
Readiness da conta

Chave correta

Seu backend precisa estar usando trq_live_ apenas no ambiente real, sem compartilhar segredo com sandbox.

Endpoint público

Seu webhook precisa estar acessível por HTTPS e pronto para responder 2xx rápido.

Conta aprovada

Sua conta precisa estar marcada como APPROVED para produção. Cheque o estado no app antes de trocar a chave.

Logs úteis

Tenha checkout.id, externalId, event.id, requestId e livemode visíveis para investigação.

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

ItemTesteProdução
Prefixo da chavetrq_test_trq_live_
livemodefalsetrue
Movimentação financeiraSimuladaReal
Uso recomendadoValidação técnicaCobranç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
Nunca reutilize a mesma chave entre ambientes e nunca trate produção como extensão do sandbox.

​
Quando você está pronto para ampliar o uso

Sinal verde para avançar

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.

​
Próximos passos

Webhooks

Revise assinatura, reentregas e como responder o endpoint em produção.

Erros

Entenda o que fazer se uma chamada falhar ou um webhook não puder ser processado.

Boas práticas

Use um checklist simples para manter checkout, logs e reconciliação em ordem.

​
Precisa de ajuda para seguir?

Voltar ao sandbox

Se ainda faltar uma validação, volte ao ambiente de teste antes de subir mais tráfego real.

Revisar autenticação

Confira chaves, ambiente e idempotência antes de trocar segredos no backend.

Abrir o app

Revise chaves, ambiente e configuração da conta direto no app da troqpay.