Eventos por família

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
  }
}
idtexto

Identificador do evento (evt_ + número).

tipotexto

Sempre teste.ping.

criado_emdata

Hora do envio.

dados.mensagemtexto

Texto fixo de teste.

dados.webhookinteiro

Nú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

  1. O seu endereço respondeu 2xx em até 5 segundos.
  2. A assinatura bateu (o teste usa o mesmo segredo dos eventos reais).
  3. O corpo foi lido cru antes de virar JSON.
  4. O seu código não quebra com evento que não conhece.