> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.coinflow.cash/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.coinflow.cash/_mcp/server.

# 🪝 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

1. Use a queue for long-running tasks to avoid timeouts and retries.
2. Always acknowledge the webhook immediately upon receipt.

> **Note**
>
> ## 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.