Eventos
| Evento | Se envía cuando |
|---|---|
| client.created | Se añade un cliente. |
| order.submitted | Se realiza una orden. |
| order.approved | Se aprueba una orden. |
| order.settled | Se liquida una orden y se emiten las fracciones. |
| distribution.approved | Se aprueba una distribución. |
| transfer.completed | Se completa una transmisión entre inversores. |
| message.received | Un cliente envía un mensaje. |
Las cargas útiles contienen identificadores, números e importes, pero ningún dato personal. Su sistema obtiene los detalles con una clave API.
Añadir un endpoint
- Abra Configuración, después Webhooks, y elija Añadir endpoint.
- Introduzca una dirección
httpsque responda con un estado 2xx en pocos segundos. Elija los eventos. - Copie el secreto de firma. Solo se muestra una vez.
- Elija Enviar evento de prueba para comprobar que llega.
- Solo se aceptan direcciones
httpsen hosts públicos. Se rechazan las direcciones que apuntan a redes privadas o internas. - No se siguen las redirecciones.
Verificar la firma
Cada entrega es un POST JSON con las cabeceras EasyHaus-Event, EasyHaus-Delivery y EasyHaus-Signature. La firma tiene el formato t=<unix time>,v1=<hex>. Calcule un HMAC-SHA256 del texto <t>.<raw body> con su secreto, compárelo con v1 y rechace las marcas de tiempo antiguas.
El cuerpo es {id, type, created_at, organization_id, data}.
Reintentos y desactivación
- Responda en un plazo de 10 segundos. Una entrega fallida se reintenta con intervalos crecientes, hasta 10 intentos.
- Tras 20 fallos consecutivos, el endpoint se desactiva y se envía un correo electrónico a los propietarios y administradores. Corrija el problema y vuelva a activarlo, lo que reinicia el recuento.
- El registro de entregas muestra cada entrega, su estado y su código HTTP, y le permite volver a entregar.
- Puede editar los eventos, desactivar un endpoint, rotar el secreto (el anterior deja de funcionar de inmediato) o eliminarlo.