Webhook Events

Whenever a payment's state changes, ARYZE POSTs a JSON body to the webhook URL on the API key you authenticated with. Each page below documents one event type — its payload, retry semantics, and an example handler.

Delivery semantics

• Method: POST with Content-Type: application/json.
• Success: any HTTP 2xx within 10 seconds.
• Retries: 1 initial delivery + 3 retries at 1 s, 5 s, 15 s.
• Signature verification: payloads are not signed today. Cross-check every event by fetching the transaction from GET /v1/payments/{transactionId} before acting on it.

See Consume webhooks for an end-to-end handler with idempotency and error handling.