Todos os eventos
Todos os eventos que o seu servidor pode receber. Cada família tem uma página com a tabela de campos e o JSON completo de cada evento.
Lista de eventos
| Evento | Quando | dados | Detalhes |
|---|---|---|---|
venda.criada | Venda criada (Pix gerado) | Cobrança | Ver JSON |
venda.aprovada | Venda aprovada | Cobrança | Ver JSON |
venda.expirada | Pix expirado | Cobrança | Ver JSON |
venda.reembolsada | Venda reembolsada | Cobrança | Ver JSON |
med.aberto | MED aberto | MED | Ver JSON |
med.encerrado | MED encerrado | MED | Ver JSON |
saque.concluido | Saque concluído | Saque | Ver JSON |
saque.falhou | Saque não realizado | Saque | Ver JSON |
venda.contestada | Venda contestada (MED perdido) | Cobrança | Ver JSON |
teste.ping | Botão Testar do painel. | Mensagem | Ver JSON |
Famílias
| Página | Eventos | dados |
|---|---|---|
| Venda | venda.criada, venda.aprovada, venda.expirada, venda.reembolsada, venda.contestada | Objeto cobrança |
| MED | med.aberto, med.encerrado | Disputa (med_) |
| Saque | saque.concluido, saque.falhou | Saque (saq_) |
| Teste | teste.ping | Mensagem |
Formato de todo evento
Todo aviso chega no mesmo envelope. Só o conteúdo de dados muda de uma família para outra.
{
"id": "evt_5821",
"tipo": "venda.aprovada",
"sequencia": 5821,
"criado_em": "2026-10-15T14:32:10-03:00",
"livemode": true,
"dados": { "...": "depende do evento" }
}idtextoIdentificador do evento (evt_ + número). Não muda nas novas tentativas: use para ignorar repetição.
tipotextoO nome do evento, igual ao cabeçalho X-Grinny-Event.
sequenciainteiroCresce na ordem em que os eventos aconteceram. Não vem no teste.ping.
criado_emdataQuando o evento aconteceu.
livemodebooleanotrue em venda de verdade, false em evento da chave de teste (veja Modo de teste). Não vem no teste.ping.
dadosobjetoO conteúdo do evento, como estava naquele momento (mesmo numa nova tentativa).
Ao cadastrar o webhook no painel você escolhe quais eventos quer receber. Evento que você não escolheu nunca é enviado para aquela URL.