Skip to main content

​
Liquidação em USDT

Na troqpay, o comprador vê e paga a cobrança em BRL, mas você também pode acompanhar dados de liquidação em USDT. Isso muda a forma de ler a API:
  • a cobrança continua sendo criada em reais
  • o Pix continua sendo o meio de pagamento do comprador
  • a liquidação aparece no objeto settlement

​
O que isso significa na prática

Para o comprador

O valor sempre aparece em BRL e o pagamento acontece por Pix.

Para o seu sistema

É no checkout que você acompanha o estado da cobrança.

Para a liquidação

O objeto settlement mostra a moeda, o status e o valor relacionado à liquidação.

Para a conciliação

Você pode olhar para a cobrança em BRL e para a liquidação em USDT sem misturar as duas leituras.

​
Como interpretar isso na API

Hoje, na API pública:
  • amount representa BRL em centavos
  • currency deve ser BRL
  • pix descreve o pagamento do comprador
  • settlement.currency mostra a moeda de liquidação
  • settlement.status mostra o andamento da liquidação
  • settlement.amount mostra o valor relacionado à liquidação em USDT

​
Exemplo

{
  "id": "chk_01HR7P8Z5N7A8Q2P8Y7F2D8Q6J",
  "amount": 12990,
  "currency": "BRL",
  "status": "PAID",
  "settlement": {
    "currency": "USDT",
    "status": "AVAILABLE",
    "amount": "24.560000"
  }
}

​
O que seu sistema deve assumir

  • o comprador sempre vê e paga o valor em BRL
  • a conciliação da cobrança continua sendo feita pelo checkout
  • a leitura de liquidação deve olhar para o objeto settlement
  • settlement.amount deve ser tratado como decimal em string
Esta página explica como ler os dados de liquidação em USDT dentro do checkout. Para a referência completa dos campos, use a API Reference.