Receptor completo
Um receptor completo, do pedido chegando até a resposta: confere a assinatura, ignora evento repetido, ignora evento atrasado e responde rápido. Copie e troque só o trecho "libere o acesso".
O que o código faz
- Lê o corpo cru do pedido.
- Confere a assinatura e a hora (até 5 minutos de diferença). Falhou:
401. - Grava o
iddo evento. Já existia: responde200sem fazer nada (repetição). - Compara a
sequenciacom a última já processada daquela cobrança. Menor: ignora (evento atrasado). - Trata o evento e responde
200em até 5 segundos.
Código
<?php
// webhook.php: PHP 8 + MySQL (PDO). Segredo no ambiente, nunca no código.
// Tabela: CREATE TABLE eventos_grinny (id VARCHAR(40) PRIMARY KEY, recurso VARCHAR(64), sequencia BIGINT, criado TIMESTAMP DEFAULT CURRENT_TIMESTAMP);
$pdo = new PDO(getenv('DB_DSN'), getenv('DB_USER'), getenv('DB_PASS'), [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$corpo = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_GRINNY_SIGNATURE'] ?? ''), $s);
$esperado = hash_hmac('sha256', ($s['t'] ?? '') . '.' . $corpo, getenv('GRINNY_WEBHOOK_SECRET'));
if (!hash_equals($esperado, $s['v1'] ?? '') || abs(time() - (int) ($s['t'] ?? 0)) > 300) {
http_response_code(401);
exit;
}
$evento = json_decode($corpo, true);
if (!is_array($evento) || !isset($evento['id'], $evento['tipo'])) {
http_response_code(400);
exit;
}
if ($evento['tipo'] === 'teste.ping') {
http_response_code(200); // botão Testar do painel
exit;
}
// Qual cobrança, MED ou saque é este evento?
$d = $evento['dados'];
$recurso = $d['cobranca'] ?? $d['id'];
$seq = (int) ($evento['sequencia'] ?? 0);
$pdo->beginTransaction();
// 1) Repetição: o mesmo id nunca é tratado duas vezes.
$novo = $pdo->prepare('INSERT IGNORE INTO eventos_grinny (id, recurso, sequencia) VALUES (?, ?, ?)');
$novo->execute([$evento['id'], $recurso, $seq]);
if ($novo->rowCount() === 0) {
$pdo->commit();
http_response_code(200);
exit;
}
// 2) Atrasado: já tratei um evento mais novo deste mesmo recurso?
$mais = $pdo->prepare('SELECT MAX(sequencia) FROM eventos_grinny WHERE recurso = ? AND id <> ?');
$mais->execute([$recurso, $evento['id']]);
if ((int) $mais->fetchColumn() > $seq) {
$pdo->commit();
http_response_code(200);
exit;
}
switch ($evento['tipo']) {
case 'venda.aprovada':
// libere o acesso do pedido $d['referencia'] (valor pago: $d['valor'] centavos)
break;
case 'venda.reembolsada':
case 'venda.contestada':
// tire o acesso do pedido $d['referencia']
break;
case 'venda.expirada':
// cancele o pedido $d['referencia']
break;
case 'med.aberto':
case 'med.encerrado':
case 'saque.concluido':
case 'saque.falhou':
// registre no seu financeiro
break;
}
$pdo->commit();
http_response_code(200);// webhook.js: Node 18+ com Express. Troque o Map por uma tabela no seu banco.
import crypto from 'node:crypto';
import express from 'express';
const app = express();
const vistos = new Set(); // ids de evento já tratados
const ultimaSequencia = new Map(); // recurso -> maior sequência tratada
function assinaturaValida(req) {
const p = Object.fromEntries(
String(req.get('X-Grinny-Signature') || '').split(',').map((x) => x.split('=')),
);
const esperado = crypto
.createHmac('sha256', process.env.GRINNY_WEBHOOK_SECRET)
.update(`${p.t}.${req.body}`)
.digest('hex');
const iguais = p.v1 && p.v1.length === esperado.length &&
crypto.timingSafeEqual(Buffer.from(esperado), Buffer.from(p.v1));
return iguais && Math.abs(Date.now() / 1000 - Number(p.t)) <= 300;
}
// express.raw: o corpo chega como Buffer, sem virar JSON antes da conferência.
app.post('/webhooks/grinny', express.raw({ type: 'application/json' }), (req, res) => {
if (!assinaturaValida(req)) return res.sendStatus(401);
const evento = JSON.parse(req.body);
if (evento.tipo === 'teste.ping') return res.sendStatus(200);
// 1) Repetição
if (vistos.has(evento.id)) return res.sendStatus(200);
vistos.add(evento.id);
// 2) Atrasado
const d = evento.dados;
const recurso = d.cobranca || d.id;
if ((ultimaSequencia.get(recurso) || 0) > evento.sequencia) return res.sendStatus(200);
ultimaSequencia.set(recurso, evento.sequencia);
switch (evento.tipo) {
case 'venda.aprovada':
// libere o acesso do pedido d.referencia (valor pago: d.valor centavos)
break;
case 'venda.reembolsada':
case 'venda.contestada':
// tire o acesso do pedido d.referencia
break;
case 'venda.expirada':
// cancele o pedido d.referencia
break;
default:
// med.* e saque.*: registre no seu financeiro
}
res.sendStatus(200); // responda rápido; trabalho pesado vai para uma fila
});
app.listen(3000);Cuidados
- Responda primeiro, trabalhe depois. Se o trabalho demora (e-mail, nota fiscal), grave numa fila e responda
200na hora. Passou de 5 segundos conta como falha e o evento volta. - A conferência de repetição precisa ser atômica. No exemplo PHP o
INSERT IGNOREcom chave primária faz isso: dois avisos iguais ao mesmo tempo não passam os dois. - Erro seu = devolva 5xx. Se o banco do seu sistema caiu, responda
500(e desfaça o registro do evento): assim ele volta mais tarde. Responder 200 sem ter tratado perde a venda. - Evento desconhecido: responda
200e ignore. Novos eventos podem surgir.
No exemplo PHP, o 200 do "já vi este evento" só vale porque o tratamento anterior terminou. Se o seu código gravar o id e depois falhar, desfaça (rollBack) e responda 500, como a transação do exemplo faz quando uma exceção sobe.