Webhooks
Webhooks
Assine eventos para ser notificado em tempo real sobre mudanças de status de cobranças, recebíveis e estabelecimentos.
Exemplo de payload
Evento — charge.paid
{
"event": "charge.paid",
"created_at": "2026-07-17T14:35:12Z",
"data": {
"id": "ch_3f9a1c2d8e",
"status": "paid",
"amount": 15000,
"merchant_id": "mch_7a1b2c"
}
}Validação de assinatura
Cada evento é assinado com HMAC SHA-256 no cabeçalho X-Futuropay-Signature. Valide a assinatura antes de processar o evento.
Validação — Node.js
// Node.js — validação de assinatura (exemplo)
import crypto from "node:crypto";
function isValidSignature(payload, signature, secret) {
const expected = crypto
.createHmac("sha256", secret)
.update(payload)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(signature)
);
}Eventos disponíveis
| Evento | Descrição |
|---|---|
| charge.created | Uma cobrança foi criada. |
| charge.paid | Uma cobrança foi paga e confirmada. |
| charge.failed | Uma cobrança falhou ou foi negada. |
| receivable.registered | Um recebível foi registrado na registradora. |
| merchant.approved | Um estabelecimento foi aprovado no onboarding. |