FastGivr Billing API

Appearance

Webhooks recebidos ​

WARNING

Fluxo ligado aos módulos descontinuados (/quickpay, /billing). Continua válido para quem já os utiliza.

A FastGivr envia notificações HTTP para a URL do seu sistema quando um evento acontece (uma cobrança é paga, um Pix é recebido, um saque é concluído, etc.). Isso evita que você fique consultando a API em loop.

Como funciona ​

  1. Cadastre a URL de webhook da sua aplicação nas configurações da conta.
  2. Quando um evento ocorre, a FastGivr faz um POST para essa URL com o payload do evento.
  3. Seu sistema deve responder rápido com HTTP 2xx. Se não responder 2xx, a entrega é re-tentada automaticamente.
  4. Consulte o histórico de entregas em /access/webhook-notifications.

Boas práticas ​

  • Responda 200 imediatamente e processe o evento de forma assíncrona.
  • Trate entregas duplicadas de forma idempotente (o mesmo evento pode chegar mais de uma vez).
  • Sempre confirme o estado na API (GET do recurso) antes de liberar valor.
  • Os tipos e status de webhook estão em /enums/webhook-type e /enums/webhook-status.

Endpoints relacionados ​

MétodoCaminhoAuthDescrição
GET/access/webhook-notifications🔒Lista as entregas de webhook (status, tentativas, timestamps).
GET/access/webhook-notifications/{id}🔒Detalha uma entrega: payload enviado e resposta recebida.
POST/quickpay/webhooks/send-charge/{chargeId}🔒Reenvia manualmente o webhook de uma cobrança específica.

Fluxo ​