Webhooks

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

EventoQuandodadosDetalhes
venda.criadaVenda criada (Pix gerado)CobrançaVer JSON
venda.aprovadaVenda aprovadaCobrançaVer JSON
venda.expiradaPix expiradoCobrançaVer JSON
venda.reembolsadaVenda reembolsadaCobrançaVer JSON
med.abertoMED abertoMEDVer JSON
med.encerradoMED encerradoMEDVer JSON
saque.concluidoSaque concluídoSaqueVer JSON
saque.falhouSaque não realizadoSaqueVer JSON
venda.contestadaVenda contestada (MED perdido)CobrançaVer JSON
teste.pingBotão Testar do painel.MensagemVer JSON

Famílias

PáginaEventosdados
Vendavenda.criada, venda.aprovada, venda.expirada, venda.reembolsada, venda.contestadaObjeto cobrança
MEDmed.aberto, med.encerradoDisputa (med_)
Saquesaque.concluido, saque.falhouSaque (saq_)
Testeteste.pingMensagem

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

Identificador do evento (evt_ + número). Não muda nas novas tentativas: use para ignorar repetição.

tipotexto

O nome do evento, igual ao cabeçalho X-Grinny-Event.

sequenciainteiro

Cresce na ordem em que os eventos aconteceram. Não vem no teste.ping.

criado_emdata

Quando o evento aconteceu.

livemodebooleano

true em venda de verdade, false em evento da chave de teste (veja Modo de teste). Não vem no teste.ping.

dadosobjeto

O 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.