charge.paid é o evento sobre o qual o seu sistema deve agir: liberar acesso, faturar, dar baixa no
pedido.
Cadastro
Você cadastra vários endpoints em Desenvolvedores. Produção e homologação são sistemas diferentes, e cada um recebe só os eventos que assinou, com o seu próprio segredo de assinatura. Um segredo por endpoint significa que o segredo de homologação vazado não permite forjar eventos em produção.O envelope
Todo evento tem a mesma forma:Uma entrega por fato
Cada fato vira no máximo uma entrega por endpoint. Uma reentrega do provedor para nós não vira uma segunda entrega para você. Uma entrega que desistiu depois das retentativas pode ser reenviada à mão pelo painel — e aí oid
do evento é o mesmo, para a sua idempotência reconhecê-lo.
O que responder
Qualquer2xx encerra a entrega. Qualquer coisa fora dessa faixa agenda nova tentativa.
Grave o evento, responda
200 e deixe o processamento para uma fila. Responder rápido é o que
evita que a retentativa chegue enquanto você ainda processa o primeiro. O padrão completo está em
Entregas e retentativas.Veja também
Verificar a assinatura
O passo que não dá para pular.
Entregas e retentativas
Como deduplicar pelo
id do evento.Ficou algo de fora? Escreva para suporte@usevext.com. Se o assunto for uma chamada específica, informe o horário dela; se for uma entrega de webhook, informe o
X-Vext-Delivery — é por ele que localizamos a tentativa, a resposta do seu servidor e o horário.