> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar transação

> Retorna o resumo de uma transação do TrustPass, incluindo o status atual. Pensado para a tela de checkout.

## Path Parameters

<ParamField path="id" type="string" required>
  ID da transação.
</ParamField>

## Response

<ResponseField name="id" type="string">
  ID da transação.
</ResponseField>

<ResponseField name="payment" type="object">
  Dados da compra.

  <Expandable title="Propriedades de payment">
    <ResponseField name="merchant" type="string">
      Nome do lojista.
    </ResponseField>

    <ResponseField name="amount" type="number">
      Valor da compra.
    </ResponseField>

    <ResponseField name="currency" type="string">
      Moeda da compra.

      **Exemplo**: `BRL`
    </ResponseField>

    <ResponseField name="cardBin" type="string">
      BIN do cartão utilizado.
    </ResponseField>

    <ResponseField name="cardLast4" type="string">
      Últimos 4 dígitos do cartão utilizado.
    </ResponseField>

    <ResponseField name="purchasedAt" type="string">
      Data e hora da compra.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="identity" type="object">
  Dados do documento em validação.

  <Expandable title="Propriedades de identity">
    <ResponseField name="masked" type="string">
      Documento (CPF/CNPJ) mascarado.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="buyerName" type="string">
  Nome do comprador, quando disponível. `null` caso ainda não tenha sido identificado.
</ResponseField>

<ResponseField name="validated" type="boolean">
  Indica se a identidade já foi validada com sucesso.
</ResponseField>

<ResponseField name="hasPasskey" type="boolean">
  Indica se o titular possui uma passkey cadastrada.
</ResponseField>

<ResponseField name="biometricsAttempts" type="integer">
  Número de tentativas de biometria (liveness + ID Check) já realizadas.
</ResponseField>

<ResponseField name="returnUrl" type="string">
  URL de retorno ao final do fluxo. `null` quando não configurada.
</ResponseField>

<ResponseField name="status" type="string">
  Status atual da transação. Veja a [lista completa de status](/plataforma/trustpass/fluxo-titular-terceiro#status-da-transação).
</ResponseField>

<ResponseField name="expiresAt" type="integer">
  Timestamp (epoch, milissegundos) em que a transação expira.
</ResponseField>

<Note>
  Este endpoint é voltado para a tela de checkout e **não** inclui o motivo detalhado de reprovação/fraude nem os sinais de dispositivo. Para esses dados, consulte a [API de inteligência da transação](/plataforma/trustpass/api/get-transacao-inteligencia).
</Note>

## Códigos de erro

| Código HTTP | Descrição                    |
| :---------- | :--------------------------- |
| 401         | API key ausente ou inválida. |
| 404         | Transação não encontrada.    |