Gatilhos de Venda

Visão geral Gatilhos Estrutura FAQ Solicite ajuda

Introdução · Webhook Even3 / Vendas

Gatilhos de venda

Receba notificações automáticas sobre tentativas de compra, pagamentos aprovados, recusas, cancelamentos e reembolsos no seu evento.

Webhook de vendas

O Webhook é uma ferramenta que permite que sistemas externos sejam notificados automaticamente quando determinadas ações ocorrem na plataforma Even3.

Ao configurar uma URL para recebimento, a Even3 enviará uma requisição HTTP POST com os dados relevantes da venda no momento em que uma ação ocorrer.

Para utilizar os gatilhos de venda, o organizador deverá cadastrar uma ou mais URLs de destino e selecionar quais ações deseja monitorar. Esta página contempla somente ações relacionadas ao fluxo financeiro de inscrições pagas.

Dica: o ideal é configurar uma URL específica para cada ação. Porém, também é possível utilizar uma única URL para todos os gatilhos. Com os dados enviados pela Even3 no corpo do POST, é possível identificar a qual ação a notificação se refere.

Descrição de cada ação

Gatilhos de venda

Abaixo estão os gatilhos disponíveis para acompanhar as etapas de uma transação financeira, desde a geração da tentativa de compra até a sua aprovação, reprovação ou cancelamento.

Nome do gatilho	Quando é disparado	Momento do envio para fila	Observação
Venda iniciada	Quando um participante acessa o checkout e gera uma tentativa de compra.	Imediatamente após gerar o pagamento.	É disparado independentemente do método de pagamento escolhido.
Venda aprovada	Quando o pagamento é confirmado.	Imediatamente após a confirmação de pagamento.	Pode ocorrer para pagamentos realizados por cartão, boleto ou Pix.
Venda reprovada	Quando o pagamento falha, é recusado, expira ou apresenta algum erro.	Assim que a falha é registrada.	A inscrição relacionada pode permanecer pendente enquanto não houver uma nova tentativa ou confirmação de pagamento.
Venda cancelada / reembolsada	Quando uma venda é cancelada ou reembolsada.	Imediatamente após o cancelamento ou reembolso.	Pode ocorrer por solicitação manual da organização ou automaticamente, como em casos de chargeback.

Importante: eventos gratuitos não geram gatilhos de venda. Para acompanhar inscrições desses eventos, utilize os gatilhos de participante.

Payload

Estrutura da notificação

Todo envio terá a informação de qual ação ele se refere. No exemplo abaixo, a ação é Venda aprovada.

Toda ação enviada terá um identificador único para cada disparo.

Identificação da ação

{
"id": "d8ddd69c-af1d-4bc5-b20e-02d6d100a2a8",
"created": 9999999999,
"type": {
"id": 10,
"name": "Venda aprovada"
},
"data": {
"venda": {
"venda.id": 99999999,
"venda.referencia": "ABC123",
"venda.data_pagamento": "2026-08-03T10:15:22.123",
"venda.status": "Pago",
"venda.valor_bruto": 999.00,
"item_venda.valor_bruto_real": 999.00,
"venda.valor_liquido": 999.00,
"venda.desconto_even3": 9.99,
"venda.metodo_pagamento": "Cartão de Crédito",
"venda.tipo_pagamento": "Visa",
"venda.cupom_desconto": "",
"pagador.tipo_pessoa": "PF",
"pagador.nome_razao_social": "Pagador Even3",
"pagador.email": "pagador@even3.com",
"pagador.cpf_cnpj": "999.999.999-99",
"pagador.endereco.bairro": "Even3",
"pagador.endereco.cep": "99999-999",
"pagador.endereco.cidade": "Recife",
"pagador.endereco.logradouro": "Even3",
"pagador.endereco.numero": "999",
"pagador.endereco.uf": "PE",
"itens": [
{
"item_venda.id": 7,
"item_venda.id_especifico": 6,
"item_venda.tipo": "Inscrição evento",
"item_venda.titulo": "Inscrição Lote 1",
"item_venda.quantidade": 3,
"item_venda.valor_bruto": 999.00,
"item_venda.valor_bruto_real": 999.00,
"participante.nome": "Pagador",
"participante.email": "pagador@even3.com"
}
],
"evento.titulo": null,
"evento.url": null,
"evento.motivo_recusa": null
},
"evento": {
"id": 1,
"url": "urlevento",
"titulo": "Evento Teste",
"data": "2026-09-10T09:00:00",
"estado": "Pernambuco",
"cidade": "Recife"
}
}
}

Boa prática: utilize o identificador único de cada disparo para evitar processar a mesma ação mais de uma vez. Em caso de falha ou timeout, a Even3 pode reenviar uma notificação conforme a política de reenvio.

Dúvidas frequentes

FAQ — Gatilhos de venda

Qual a diferença entre inscrição e venda?

Inscrição: ato de se cadastrar no evento, independentemente do pagamento.

Venda: ato de adquirir um ingresso pago, gerando uma transação financeira. Eventos gratuitos não geram gatilhos de venda, apenas gatilhos de inscrição.

O que acontece se a pessoa gera um pagamento, mas não paga?

Você poderá receber dois gatilhos: Venda iniciada e Participante com inscrição pendente no evento.

A pessoa se inscreveu e pagou. Quais gatilhos são enviados?

Nesse caso, são enviados os gatilhos Venda aprovada e Participante com inscrição confirmada no evento.

O que acontece se uma venda for cancelada?

Por padrão, cancelar uma venda também cancela a inscrição vinculada. Nesse cenário, são disparados os gatilhos Venda cancelada/reembolsada e Participante com inscrição cancelada no evento.

Como faço para relacionar uma venda a uma inscrição?

O payload do gatilho de confirmação de inscrição inclui o código do ingresso. Esse mesmo código estará presente no gatilho de venda, permitindo relacionar os dois registros.

Por que preciso tratar notificações repetidas?

Em caso de falha ou timeout, a Even3 pode reenviar a mesma notificação conforme a política de reenvio. Por isso, sua aplicação deve utilizar o identificador único de cada disparo para evitar processar a mesma ação mais de uma vez.