Skip to main content

Introdução

A troqpay ajuda você a vender no Brasil com Pix e acompanhar a cobrança pela API. Nesta documentação, você vai aprender a:
  • criar um checkout Pix
  • acompanhar o status da cobrança
  • receber eventos por webhook
  • operar com chaves de teste e produção

Quando faz sentido integrar a troqpay

Use a troqpay quando você precisa:
  • gerar cobranças Pix a partir do seu próprio backend
  • conciliar pagamentos com externalId
  • reagir ao pagamento em tempo real
  • cobrar em BRL e acompanhar dados de liquidação em USDT no mesmo checkout

Em uma frase

Seu cliente paga em BRL, seu sistema acompanha o checkout e os dados de liquidação em USDT aparecem no objeto settlement.

Como pensar na API

Tudo gira em torno do Checkout. É nele que você encontra:
  • o valor cobrado em BRL
  • os dados do Pix para pagamento
  • o status da cobrança
  • os metadados do seu pedido
  • as informações de liquidação em USDT

Fluxo típico

1

Criar checkout

Seu backend envia um POST /v1/checkouts com o valor, a descrição e os dados da cobrança.
2

Exibir o Pix para o comprador

A API responde com copyPaste, qrCodeUrl e checkoutUrl, para você escolher o melhor formato de exibição.
3

Acompanhar o pagamento

Você pode consultar a API, mas o caminho recomendado é processar os webhooks.
4

Atualizar seu sistema

Quando o pagamento é confirmado, o checkout muda de status e o objeto settlement passa a mostrar os dados de liquidação.

O que você consegue fazer hoje

O que você encontra aqui

Checkouts Pix, autenticação, ambiente de teste, webhooks, erros e dados de liquidação em USDT.

Como navegar nesta documentação

Se você quer integrar rápido, comece pelo Quickstart. Se você já entende o fluxo, siga por Checkouts Pix, Webhooks e API Reference.

Próximos passos