Consultar Venda no Terminal
curl --request GET \
--url https://pay.autorizou.dev/api/v1/pos/sales/{identifier} \
--header 'Authorization: Bearer <token>'import requests
url = "https://pay.autorizou.dev/api/v1/pos/sales/{identifier}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://pay.autorizou.dev/api/v1/pos/sales/{identifier}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://pay.autorizou.dev/api/v1/pos/sales/{identifier}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://pay.autorizou.dev/api/v1/pos/sales/{identifier}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://pay.autorizou.dev/api/v1/pos/sales/{identifier}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://pay.autorizou.dev/api/v1/pos/sales/{identifier}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"state": "<string>",
"payment": {},
"updated_at": "<string>"
}POS / Maquininhas
Consultar Venda no Terminal
Consulta o estado atual de uma venda presencial — a forma segura de resolver o estado unknown
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>'import requests
url = "https://pay.autorizou.dev/api/v1/pos/sales/{identifier}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://pay.autorizou.dev/api/v1/pos/sales/{identifier}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://pay.autorizou.dev/api/v1/pos/sales/{identifier}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://pay.autorizou.dev/api/v1/pos/sales/{identifier}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://pay.autorizou.dev/api/v1/pos/sales/{identifier}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://pay.autorizou.dev/api/v1/pos/sales/{identifier}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
Resolvendo o estado
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
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"
}
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
| HTTP | Quando |
|---|---|
401 | Chave de API ausente ou inválida |
404 | Nenhuma venda com esse identifier no seu lojista |