A plataforma recebe notificações do provedor de liquidação nos endpoints configurados, por exemplo:
  • https://seu-dominio.com/api/webhooks/bspay
  • https://seu-dominio.com/api/webhooks/gateway
O mesmo handler processa o corpo JSON e atualiza transações e carteira quando aplicável.

postbackUrl nas transações

Ao criar cobrança ou saque, você pode enviar postbackUrl apontando para sua URL. O encaminhamento de eventos para a sua URL segue a configuração de postback do painel e das integrações v1/v2.

Formatos aceitos

  1. Payload plano: campos no primeiro nível do JSON (modelo descrito nas páginas Cash-in e Cash-out).
  2. Envelope requestBody: { "requestBody": { ... } } — o servidor normaliza para o objeto interno antes de processar.
Veja exemplos nas páginas Cash-in e Cash-out.