Teste (teste.ping)
Para conferir se o seu endereço recebe e valida os avisos antes de uma venda de verdade, use o botão Testar do webhook no painel (Integrações › Webhooks).
Como funciona
- O botão manda na hora um evento
teste.ping, com a mesma assinatura e os mesmos cabeçalhos dos eventos reais. - O endereço passa pela mesma checagem (https, domínio que aponta para um servidor público).
- O teste não tenta de novo sozinho: se o seu servidor falhar, o painel mostra o código HTTP ou o erro.
- Existe um limite de testes seguidos (10 a cada 10 minutos por conta).
- O teste não vira venda, não mexe em saldo e não vai para os outros webhooks nem para o celular.
O evento teste.ping
{
"id": "evt_5830",
"tipo": "teste.ping",
"criado_em": "2026-10-15T14:50:00-03:00",
"dados": {
"mensagem": "Envio de teste da Grinny Pay. Pode ignorar.",
"webhook": 12
}
}idtextoIdentificador do evento (evt_ + número).
tipotextoSempre teste.ping.
criado_emdataHora do envio.
dados.mensagemtextoTexto fixo de teste.
dados.webhookinteiroNúmero do seu webhook no painel.
O teste.ping não tem o campo sequencia. Se o seu código lê sequencia de todo evento, trate a falta dele. Responda 2xx e ignore o conteúdo.
O que conferir no teste
- O seu endereço respondeu 2xx em até 5 segundos.
- A assinatura bateu (o teste usa o mesmo segredo dos eventos reais).
- O corpo foi lido cru antes de virar JSON.
- O seu código não quebra com evento que não conhece.