Deliveries

This page describes how ALPHA delivers webhook events, how retries work, and how your HTTP responses affect delivery status.

Delivery statuses

Status	Description
pending	Accepted and waiting for the first delivery attempt
retrying	A previous attempt failed and another attempt is scheduled
delivered	Your endpoint returned a successful 2xx response
failed	No further retries will be attempted

---

Retry schedule

ALPHA attempts each delivery up to 4 times (1 initial attempt plus 3 retries):

Attempt	When
Retry 1	30 seconds after the initial attempt
Retry 2	2 minutes after retry 1
Retry 3	10 minutes after retry 2

After the fourth failure, status becomes failed.

---

Idempotency

The same event can be delivered more than once when retries occur. Store processed event id values and skip duplicates. You may also guard on data.order_id for order-level safety.

---

HTTP response handling

Response	Description
2xx	Marked delivered
5xx	Retried until the attempt limit
1xx, 3xx, 4xx	Marked failed immediately (no retries)
Network errors / timeouts	Retried

Important

Respond within 10 seconds. Return 2xx only after the event is durably accepted (for example written to a queue or database).

---

See also

Configure endpoints

Register and manage webhook endpoints.

Configure endpoints

Verify signatures

Signature verification requirements.

Verify signatures