Symptom
An expected payment event occurred, but your Webhook endpoint did not receive a request.Likely causes
- The configured Webhook URL is wrong or points to an old endpoint.
- The URL is not public or cannot be reached from the internet.
- Your endpoint returns a non-
2xxresponse. - Your endpoint times out before responding.
- A firewall, WAF, or reverse proxy blocks the request.
- Local development uses no tunnel or a stale tunnel URL.
- The expected event type does not match the action that occurred.
Check this in Kyren
- Compare the Webhook URL configured in the dashboard with your current endpoint.
- Confirm the URL includes the correct scheme, host, path, and trailing slash behavior.
- Confirm you are expecting an event type that Kyren sends for that payment state.
Check this in your server
- Compare your access logs with the configured Webhook URL and event time.
- Confirm the endpoint is public and accepts HTTPS
POSTrequests. - Return
2xxquickly, then process the event asynchronously if needed. - Check firewall, WAF, CDN, and load balancer rules.
- For local development, verify the active tunnel URL matches the dashboard setting.
Fix
Update the configured Webhook URL, make the endpoint publicly reachable, and return a fast2xx response. Remove network rules that block Kyren requests.