Pular para o conteúdo

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, renewPixCharge gera outro.
  • Sem pagamento, a reserva vira expired e 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;
}

Detalhes 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.

Webhooks · API e MCP · Agendria