Receber com segurança

Conferir a assinatura

Todo webhook vem assinado. Confira a assinatura antes de confiar no conteúdo: assim ninguém finge ser a Grinny Pay para liberar um acesso.

Como funciona

O cabeçalho X-Grinny-Signature traz o horário do envio (t, em segundos desde 1970) e a assinatura (v1):

X-Grinny-Signature: t=1760549530,v1=5f2b8c0d...e91a
  1. Pegue o corpo cru do pedido, exatamente como chegou (antes de transformar em JSON).
  2. Monte o texto t + "." + corpo.
  3. Calcule o HMAC-SHA256 desse texto com o segredo do webhook (whsec_...), em hexadecimal.
  4. Compare com o v1 usando uma comparação segura (tempo constante).
  5. Recuse se o t estiver a mais de 5 minutos do seu relógio.
  6. Ignore se já processou um evento com o mesmo id.

Exemplos

<?php
$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);
// Já processou este $evento['id']? Responda 200 e pare aqui.
if ($evento['tipo'] === 'venda.aprovada') {
    // libere o acesso do pedido $evento['dados']['referencia']
}
http_response_code(200);

Nunca libere acesso só porque chegou um POST no seu endereço. Sem conferir a assinatura, qualquer pessoa que descobrir a URL consegue mandar um falso venda.aprovada.

Se o segredo vazar

Exclua o webhook no painel e cadastre de novo: nasce um segredo novo. Atualize o seu servidor antes de apagar o antigo para não perder avisos.