Respond to a webhook request
This section explains how your system should handle and respond to incoming webhook requests from TransFi.
Successful Acknowledgment
- If your system responds with a status code in the
2xxrange (e.g.,200 OK), the webhook is considered successfully delivered and received. - Ensure your system processes the webhook payload within a reasonable time to avoid timeouts.
Failure Handling
- If your system responds with any status code outside the
2xxrange, the webhook delivery will be marked as failed. - TransFi may attempt retries based on the webhook retry policy to ensure the event is processed.
Best Practices
- Respond with a
2xxstatus code immediately after receiving and validating the payload. - Use asynchronous processing to handle longer-running operations, ensuring prompt acknowledgment of the webhook.
- Log all incoming webhook requests and responses for debugging and tracking purposes.
Updated 6 months ago