Skip to main content
Use o webhook transaction.paid para confirmar o pagamento. Não libere o pedido apenas porque a criação da transação retornou sucesso.

Configure

  1. Crie uma rota pública HTTPS, como POST https://api.sualoja.com/webhooks/bob.
  2. No Dashboard, abra Webhooks e clique em Adicionar webhook.
  3. Informe a URL e use a versão v2.
  4. Guarde o secret em BOB_WEBHOOK_SECRET no seu backend.
O sandbox usa o mesmo endpoint. O campo data.isSandbox identifica eventos de teste.

Receba o evento

Valide a assinatura

O header X-Webhook-Signature tem este formato:
Calcule o HMAC-SHA256 de timestamp + "." + corpo_bruto com o secret do webhook. Compare o resultado com v1 e aceite timestamps com no máximo cinco minutos.
Valide o corpo bruto recebido. Não transforme o JSON antes de calcular a assinatura.
Depois de validar, processe o evento e responda com HTTP 2xx. A Bob pode enviar o mesmo evento novamente. Use data.transactionId e event para evitar processamento duplicado. Para testar, crie uma transação com sk_test_ e use Simular pagamento.