Skip to main content
Webhooks são requisições HTTP enviadas pela Bob quando um evento acontece no seu projeto. Eles informam mudanças de estado sem exigir consultas contínuas à API.

Por que usar

O comprador pode fechar a página antes do retorno. Uma confirmação também pode acontecer depois da resposta inicial da API. Por isso, o seu backend deve confirmar o resultado pelo webhook assinado.

Fluxo de entrega

1

A Bob cria o evento

Uma mudança relevante acontece, como a confirmação de uma transação.
2

Seu endpoint recebe a requisição

A Bob envia o payload para a URL HTTPS configurada no projeto.
3

Sua aplicação valida a assinatura

Verifique a autenticidade da mensagem usando o corpo bruto da requisição.
4

Sua aplicação processa o evento

Atualize o pedido de forma idempotente e responda com sucesso.
A Bob pode repetir uma entrega. Use o identificador da transação para impedir que o mesmo evento libere um pedido mais de uma vez.

Próximos passos

Configurar webhooks

Eventos, versões de payload, assinatura e exemplos de implementação.

Transações

Entenda os estados que os eventos comunicam.