---
updatedAt: 2026-05-28T02:21:00.000Z
agentTools:
  projectIndex: https://checkout-docs.transfi.com/llms.txt
---

# Responding to Webhook Requests

This section explains how your system should handle incoming webhook requests from TransFi Checkout.

### Successful Acknowledgment

* A webhook delivery is considered successful when your endpoint responds with an HTTP status code in the `2xx` range (for example, `200 OK`).
* Your system should validate the webhook payload before acknowledging the request.
* Return a `2xx` response immediately after successfully receiving and validating the payload.
* Ensure the webhook is processed within a reasonable time to avoid request timeouts.

### Failed Deliveries

* Any response outside the `2xx` range will be treated as a failed webhook delivery.
* Network failures or request timeouts may also result in a failed delivery attempt.
* TransFi may retry failed webhook deliveries based on the configured retry policy.

### Best Practices

* Process webhook events asynchronously for long-running operations.
* Implement idempotent webhook handling to safely process duplicate webhook events.
* Log all incoming webhook requests and responses for monitoring and debugging.
* Secure your webhook endpoint by validating incoming requests before processing.