Skip to main content
GET
Buscar Transação
Retorna os detalhes completos de uma transação específica da sua conta.
A resposta vem no envelope {status, data} — o objeto da transação fica em data.
string
required
Sua API Key (sk_live_...). Veja Autenticacao.
string
required
Identificador único da transação.Exemplo: txn_uuid_aqui

Resposta

string
Identificador único da transação.
integer
Valor da transação em centavos.
string
Método de pagamento: PIX.
Novos valores podem ser adicionados a este campo. Trate valores desconhecidos como fallback. Não faça switch exaustivo.
string
Status atual da transação. Valores: PENDING, WAITING_PAYMENT, PROCESSING, AUTHORIZED, PAID, REFUSED, FAILED, EXPIRED, REFUNDED, PARTIALLY_REFUNDED, CHARGEDBACK, DISPUTE, BLOCKED, PENDING_REVIEW.
Novos valores podem ser adicionados a este campo. Trate valores desconhecidos como fallback. Não faça switch exaustivo.
string
Data/hora de criação (ISO 8601).
string
Data/hora em que a transação foi paga (ISO 8601). Presente apenas quando status = PAID ou posterior.
string
Data/hora da última alteração (ISO 8601).
object
Dados do comprador definidos na criação. customer.document vem redigido (só primeiros e últimos 2 dígitos visíveis).
object
Metadados da transação definidos por você na criação.
string
Descrição da cobrança informada por você na criação. Omitido quando não informado.
string
Seu identificador de pedido, informado na criação. Omitido quando não informado.
string
URL de notificação assíncrona informada por você na criação. Omitido quando não informado.
object
Dados do PIX da cobrança: copyPaste, qrCode e expiresAt. Os mesmos valores retornados na criação — permitem reexibir o QR sem guardar a resposta original. Omitido em cobranças criadas antes desta versão.
string
Identificador fim-a-fim (E2E) do PIX no SPI. Preenchido quando o pagamento é confirmado; omitido enquanto a cobrança não foi paga.
integer
Taxa cobrada, em centavos. Omitido enquanto a transação não foi liquidada.
integer
Valor líquido após a taxa, em centavos. Omitido enquanto a transação não foi liquidada.
string
Referência interna para suporte e auditoria.
integer
Valor já estornado, em centavos. Omitido quando não houve estorno.
string
Tipo do estorno: FULL quando status = REFUNDED, PARTIAL quando status = PARTIALLY_REFUNDED. Omitido nos demais status.
string
Motivo da recusa. Omitido quando a transação não foi recusada.
Campos opcionais são omitidos quando não há valor — não vêm como null. Novos campos podem ser adicionados à resposta a qualquer momento; ignore os que não conhecer em vez de falhar na desserialização.

Exemplo de resposta