Eventos

O campo type do corpo (e o header x-seventyone-event) informa o evento. Ao criar o webhook você escolhe quais receber, ou usa * para todos.

Eventos de pagamento

Emitidos quando uma cobrança PIX muda de situação.

Evento	Quando	data.status
payment.created	A cobrança foi criada e o PIX gerado.	waiting_payment
payment.processing	A cobrança está aguardando o pagamento.	waiting_payment
payment.approved	O cliente pagou e o pagamento foi confirmado.	paid
payment.expired	O prazo para pagar terminou.	expired
payment.cancelled	A cobrança foi cancelada.	cancelled

payment.approved é o evento que indica dinheiro recebido: é o gatilho para liberar o pedido.

data desses eventos:

Campo	Descrição
id	payment_id (o mesmo devolvido ao criar a cobrança).
object	"payment".
pix_payment_id	Id da cobrança PIX.
external_id	O external_id que você enviou (ou null).
amount	Valor em centavos.
currency	"BRL".
status	Status atual.
merchant_id	Seu lojista.
fee_amount	Tarifa em centavos (quando disponível).
net_amount	Valor líquido em centavos (quando disponível).
fee_percent	Percentual da tarifa (quando disponível).
account	Conta de processamento de origem: { "id", "name" } ou null.

Eventos de saque

Evento	Quando
withdrawal.created	Saque solicitado.
withdrawal.approved	Saque aprovado.
withdrawal.processing	Saque em processamento.
withdrawal.paid	Saque concluído.
withdrawal.rejected	Saque rejeitado.
withdrawal.failed	Saque falhou.
withdrawal.cancelled	Saque cancelado.

data desses eventos: id, object ("withdrawal"), amount, net_amount, currency, status, merchant_id e account (a conta de processamento do saque). Dados internos do processamento nunca são enviados.

Outros tipos de evento

O painel oferece apenas os eventos das tabelas acima, que são os que a plataforma dispara. Nomes como payment.refunded, payment.refused, payment.chargeback, pix.*, wallet.updated, infraction.* e customer.* não são emitidos hoje. Webhooks antigos que os assinaram continuam válidos, mas nunca receberão esses eventos — ajuste a assinatura para os eventos listados nesta página.

Entrega única por evento

Para cada endpoint, a mesma combinação de evento e recurso (por exemplo, payment.approved do pagamento X) é registrada uma vez. Mesmo assim, por causa de retentativas, trate a recepção como pelo menos uma vez e deduplique por x-seventyone-event-id.