🪝 Webhook Implementation
Webhooks Best Practices
Respond to webhooks quickly by queuing payloads for background processing. Avoid handling them inline to prevent timeouts and retries.
Background vs. Inline Processing
- Inline: Slower—handles tasks immediately.
- Background: Faster—queues tasks, allowing immediate webhook response.
Handling Webhooks
- Use a queue for long-running tasks to avoid timeouts and retries.
- Always acknowledge the webhook immediately upon receipt.
Webhooks may be sent more than once—add deduplication logic to prevent duplicate events.
Security Tips
✅ Keep your API key secure ✅ Verify webhook authorization ✅ Validate message format
ℹ️ Coinflow will retry sending webhook events until:
- Your server returns a 200 OK
- Or 36 hours passes
- Note: Your server must respond within 5 seconds or the request will timeout and retry.
