Skip to main content

Glossário

Use esta página quando você quiser confirmar rapidamente o significado de um termo da documentação.

Termos principais

TermoO que significa
CheckoutObjeto principal da API para criar, exibir e acompanhar uma cobrança Pix
externalIdIdentificador do pedido ou registro do seu sistema
Idempotency-KeyHeader usado para evitar criações duplicadas quando a mesma requisição precisa ser reenviada
livemodeCampo que indica se o evento ou checkout veio de teste (false) ou produção (true)
settlementObjeto que concentra os dados relacionados à liquidação
requestIdIdentificador de uma chamada HTTP, útil para logs e investigação
event.idIdentificador único de um evento de webhook
copyPasteString do Pix copia e cola
qrCodeUrlURL da imagem do QR Code do Pix
checkoutUrlURL de um checkout hospedado pela troqpay

Termos de ambiente

TermoO que significa
trq_test_Prefixo de chave para ambiente de teste
trq_live_Prefixo de chave para ambiente de produção
sandboxAmbiente para validar integração sem cobranças reais
produçãoAmbiente usado para cobranças reais

Termos de status

TermoO que significa
PENDINGCheckout criado e aguardando pagamento
PAIDPagamento Pix confirmado
EXPIREDCheckout expirado sem pagamento
CANCELLEDCheckout cancelado
settlement.PENDINGLiquidação ainda em andamento
settlement.AVAILABLELiquidação disponível para leitura no checkout
settlement.COMPLETEDLiquidaçã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.