Glossário
Use esta página quando você quiser confirmar rapidamente o significado de um termo da documentação.Termos principais
| Termo | O que significa |
|---|---|
Checkout | Objeto principal da API para criar, exibir e acompanhar uma cobrança Pix |
externalId | Identificador do pedido ou registro do seu sistema |
Idempotency-Key | Header usado para evitar criações duplicadas quando a mesma requisição precisa ser reenviada |
livemode | Campo que indica se o evento ou checkout veio de teste (false) ou produção (true) |
settlement | Objeto que concentra os dados relacionados à liquidação |
requestId | Identificador de uma chamada HTTP, útil para logs e investigação |
event.id | Identificador único de um evento de webhook |
copyPaste | String do Pix copia e cola |
qrCodeUrl | URL da imagem do QR Code do Pix |
checkoutUrl | URL de um checkout hospedado pela troqpay |
Termos de ambiente
| Termo | O que significa |
|---|---|
trq_test_ | Prefixo de chave para ambiente de teste |
trq_live_ | Prefixo de chave para ambiente de produção |
sandbox | Ambiente para validar integração sem cobranças reais |
produção | Ambiente usado para cobranças reais |
Termos de status
| Termo | O que significa |
|---|---|
PENDING | Checkout criado e aguardando pagamento |
PAID | Pagamento Pix confirmado |
EXPIRED | Checkout expirado sem pagamento |
CANCELLED | Checkout cancelado |
settlement.PENDING | Liquidação ainda em andamento |
settlement.AVAILABLE | Liquidação disponível para leitura no checkout |
settlement.COMPLETED | Liquidação concluída |
Próximos passos
Quickstart
Volte ao caminho mais curto para validar a integração.
Checkouts Pix
Veja onde cada termo aparece dentro do objeto principal da API.
Erros
Entenda como
requestId, code e message aparecem nas falhas.
