Skip to main content
GET
Consultar Venda no Terminal
Consulta o estado atual de uma venda presencial. É a forma segura de descobrir o desfecho quando a criação da venda voltou unknown (timeout ou queda de rede): você consulta em vez de reenviar, e nunca corre o risco de cobrar duas vezes. O {identifier} aceita duas formas: o uuid devolvido na criação ou o seu próprio external_reference.
Consultar pelo external_reference (a referência que você enviou) é o caminho mais direto para conciliar — você não precisa guardar o uuid da Autorizou do seu lado.

Parâmetros

string
required
O uuid da venda ou o seu external_reference.
cURL

Resposta

string
Estado atual da venda: initiated, approved, declined, unknown ou aborted. Enquanto for initiated ou unknown, a venda ainda pode mudar — consulte de novo. approved, declined e aborted são finais.
object
A cobrança gerada, presente quando state é approved. Traz uuid e status.
string
Última atualização do estado. Os demais campos são os mesmos da criação da venda.

Resolvendo o estado unknown

1

Não reenvie a venda

Reenviar cegamente pode cobrar o cliente duas vezes.
2

Consulte até resolver

Chame este endpoint até o state virar approved ou declined. A recuperação da Autorizou reconcilia o resultado real da maquininha.
3

Só então conclua ou tente de novo

Com o estado final em mãos, siga o fluxo normal — concluir a venda (aprovada) ou nova tentativa (recusada, com nova Idempotency-Key).

Erros