Webhooks
Situação dos webhooks de saída e como acompanhar uma reserva hoje.
Atualizado em 10 de outubro de 2026
Situação
Enquanto isso, a API pública cobre o caso mais comum, saber se uma reserva com sinal foi paga, por consulta.
Acompanhar uma reserva
Reservas com sinal nascem pending e trazem um Pix em payment, com expires_at. Consulte getBooking até o status mudar ou o Pix expirar.
- Consulte a cada 10 segundos, no máximo, e pare em
payment.expires_at. - Se o Pix expirar e o horário seguir livre,
renewPixChargegera outro. - Sem pagamento, a reserva vira
expirede o horário volta a ficar livre.
async function waitForPayment(id, token, until) {
while (Date.now() < until) {
const b = await fetch(`${base}/shops/sandbox-agendria/bookings/${id}`, {
headers: { "X-Booking-Token": token },
}).then((r) => r.json());
if (b.status !== "pending") return b;
await new Promise((r) => setTimeout(r, 10_000));
}
return null;
}import time, requests
def wait_for_payment(booking_id, token, deadline):
while time.time() < deadline:
b = requests.get(
f"{base}/shops/sandbox-agendria/bookings/{booking_id}",
headers={"X-Booking-Token": token},
).json()
if b["status"] != "pending":
return b
time.sleep(10)
return NoneDetalhes de limites e erros estão em Limites e erros.
Quer ser avisado?
Se uma integração sua depende de eventos em tempo real, diga qual em [email protected]. Isso ajuda a decidir o que sai primeiro.