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. 1

    Cadastre seu endpoint HTTPS no painel ou via API.

  2. 2

    A Blox envia uma requisição POST com payload JSON e cabeçalho de assinatura.

  3. 3

    Verifique a assinatura HMAC-SHA256 com seu secret antes de processar.

  4. 4

    Responda com status 2xx em até 10 segundos para confirmar entrega.

  5. 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.blocked

Verificando 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)
  );
}