Ferramentas e versões · v1 em prévia
Planeje eventos sem presumir uma assinatura ativa.
Webhooks notificam outro sistema quando algo acontece. Sua disponibilidade precisa ser confirmada antes de usar esse caminho.
O que precisa ser definido
Contrato dos eventos
- Catálogo e versão dos eventos.
- Formato do payload e identificador de evento.
Entrega e segurança
- Assinatura, validação e rotação de segredos.
- Política de novas tentativas, duplicatas, ordem e reenvio.
- Ambiente de teste e forma de cadastrar o destino.
O que pode ser usado agora no planejamento
Consulte o contrato de leitura e seus limites. Os endpoints que recebem notificações de provedores de pagamento são infraestrutura da Akrus e não são uma API de inscrição para integradores.
Prepare o sistema receptor sem inventar eventos
Defina como sua aplicação guardaria identificadores para evitar processamento duplicado, como registraria falhas e como conciliaria o estado atual após uma interrupção. Essas são necessidades do seu projeto; nomes de eventos, cabeçalhos e regras de assinatura só devem ser implementados após a publicação do contrato.
Dúvidas frequentes
Posso usar os webhooks de pagamento da Akrus como assinatura de eventos?
Não. Receber notificações de um provedor é uma função interna da plataforma e não oferece uma inscrição pública para sistemas de terceiros.
Descreva a necessidade de eventos
Informe o evento esperado, o sistema de destino e o tempo de atualização necessário.
Referência conferida em 23 de setembro de 2026. Relatar uma dúvida na documentação.