Webhooks
Delivery and Retries
Request format
- Method: HTTP
POST - Content-Type:
application/json - User-Agent:
IDEASOFT-WEBHOOK - Signature header:
X-Ideashop-Hmac-Sha256(see Security)
Retry rule
Depending on the response from your endpoint:
| Response | Behaviour |
|---|---|
2xx | Considered successful |
5xx | The message is re-queued and retried |
Other (3xx, 4xx, timeout) | Not retried; the delivery is dropped |
- Retries continue up to a configured requeue limit (default 3 attempts).
- When the limit is exceeded the delivery is abandoned and logged; your webhook subscription is not deleted or deactivated — subsequent events keep being sent.
- Each request uses a configured curl timeout (default 3 seconds).
Behaviour note
Retries happen only for 5xx responses. Deliveries rejected with 4xx or hitting the timeout are not retried; your endpoint must respond quickly with 2xx.
Respond fast
Your webhook handler should accept the message and return 2xx immediately; do the heavy work asynchronously.
Last modified on