DEV
Eventos em tempo real
Webhooks da Blox entregam eventos com retry exponencial, assinatura HMAC e até 7 dias de retenção em caso de falha.
Como funciona
- 1
Cadastre seu endpoint HTTPS no painel ou via API.
- 2
A Blox envia uma requisição POST com payload JSON e cabeçalho de assinatura.
- 3
Verifique a assinatura HMAC-SHA256 com seu secret antes de processar.
- 4
Responda com status 2xx em até 10 segundos para confirmar entrega.
- 5
Em caso de falha, reentregamos com backoff exponencial por até 7 dias.
Eventos disponíveis
charge.createdcharge.paidcharge.refundedcharge.failedtransfer.createdtransfer.completedtransfer.failedcustomer.createdcustomer.updatedcard.issuedcard.activatedcard.blockedVerificando assinatura
import crypto from "crypto";
function verify(payload, signature, secret) {
const expected = crypto
.createHmac("sha256", secret)
.update(payload)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
);
}