Eventos
| Evento | Enviado quando |
|---|---|
| client.created | Um cliente é adicionado. |
| order.submitted | Uma ordem é enviada. |
| order.approved | Uma ordem é aprovada. |
| order.settled | Uma ordem é liquidada e as frações são emitidas. |
| distribution.approved | Uma distribuição é aprovada. |
| transfer.completed | Uma transferência entre investidores é concluída. |
| message.received | Um cliente envia uma mensagem. |
Os payloads contêm IDs, números e valores, mas nenhum dado pessoal. Seu sistema busca os detalhes com uma chave de API.
Adicionar um endpoint
- Abra Configurações, depois Webhooks, e escolha Adicionar endpoint.
- Informe um endereço
httpsque responda com um status 2xx em poucos segundos. Escolha os eventos. - Copie o segredo de assinatura. Ele é mostrado uma única vez.
- Escolha Enviar evento de teste para verificar se ele chega.
- Somente endereços
httpsem hosts públicos são aceitos. Endereços que apontam para redes privadas ou internas são recusados. - Redirecionamentos não são seguidos.
Verificar a assinatura
Cada entrega é um POST JSON com os cabeçalhos EasyHaus-Event, EasyHaus-Delivery e EasyHaus-Signature. A assinatura tem o formato t=<unix time>,v1=<hex>. Calcule um HMAC-SHA256 do texto <t>.<raw body> com o seu segredo, compare-o com v1 e rejeite carimbos de data e hora antigos.
O corpo é {id, type, created_at, organization_id, data}.
Novas tentativas e desativação
- Responda em até 10 segundos. Uma entrega com falha é repetida com intervalos crescentes, em até 10 tentativas.
- Após 20 falhas seguidas, o endpoint é desativado e os proprietários e administradores recebem um e-mail. Corrija o problema e ative-o novamente, o que zera a contagem.
- O log de entregas mostra cada entrega, seu status e o código HTTP, e permite reenviar.
- Você pode editar os eventos, desativar um endpoint, renovar o segredo (o antigo para de funcionar imediatamente) ou excluí-lo.