Skip to main content
GET
/
api
/
v1
/
pos
/
sales
/
{identifier}
Consultar Venda no Terminal
curl --request GET \
  --url https://pay.autorizou.dev/api/v1/pos/sales/{identifier} \
  --header 'Authorization: Bearer <token>'
{
  "state": "<string>",
  "payment": {},
  "updated_at": "<string>"
}
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

​
identifier
string
required
O uuid da venda ou o seu external_reference.
cURL
curl "https://pay.autorizou.dev/api/v1/pos/sales/PEDIDO-8842" \
  -H "Authorization: Bearer SUA_CHAVE"

​
Resposta

{
  "uuid": "7c9e3b21-4a8d-4f16-9b2c-1d3e5f7a9c04",
  "state": "approved",
  "amount": 5200,
  "currency": "BRL",
  "payment_method": "credit_card",
  "installments": 3,
  "external_reference": "PEDIDO-8842",
  "terminal": {
    "code": "POI0X9Q2T7K",
    "serial_number": "S123456",
    "model": "AMS1"
  },
  "payment": {
    "uuid": "AUTOCC01KW2P8M4Q7K3M9QP",
    "status": "authorized"
  },
  "created_at": "2026-07-05 14:22:10",
  "updated_at": "2026-07-05 14:22:37"
}
​
state
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.
​
payment
object
A cobrança gerada, presente quando state é approved. Traz uuid e status.
​
updated_at
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

HTTPQuando
401Chave de API ausente ou inválida
404Nenhuma venda com esse identifier no seu lojista