Events
| Event | Sent when |
|---|---|
| client.created | A client is added. |
| order.submitted | An order is placed. |
| order.approved | An order is approved. |
| order.settled | An order is settled and fractions are issued. |
| distribution.approved | A distribution is approved. |
| transfer.completed | A transfer between investors is completed. |
| message.received | A client sends a message. |
Payloads carry ids, numbers and amounts but no personal data. Your system fetches the details with an API key.
Add an endpoint
- Open Settings, then Webhooks, and choose Add endpoint.
- Enter an
httpsaddress that answers with a 2xx status within a few seconds. Choose the events. - Copy the signing secret. It is shown once.
- Choose Send test event to check that it arrives.
- Only
httpsaddresses on public hosts are accepted. Addresses that point to private or internal networks are refused. - Redirects are not followed.
Verify the signature
Each delivery is a JSON POST with the headers EasyHaus-Event, EasyHaus-Delivery and EasyHaus-Signature. The signature looks like t=<unix time>,v1=<hex>. Compute an HMAC-SHA256 of the text <t>.<raw body> with your secret, compare it with v1, and reject old timestamps.
The body is {id, type, created_at, organization_id, data}.
Retries and switching off
- Answer within 10 seconds. A failed delivery is retried with growing delays, up to 10 attempts.
- After 20 failures in a row the endpoint is switched off and the owners and admins are emailed. Fix it, then turn it on again, which resets the count.
- The delivery log shows each delivery, its status and HTTP code, and lets you redeliver.
- You can edit the events, turn an endpoint off, rotate the secret (the old one stops at once) or delete it.