Webhooks

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Webhooks provide asynchronous status updates for quotes, payments, and payouts.

Signature verification

Kaito sends:

• Kaito-Timestamp: unix epoch seconds
• Kaito-Signature: sha256=<hex>

Compute HMAC_SHA256(secret, "{timestamp}.{raw_body}") and compare to the signature hex.

Suggested event types (V1)

• payment.created
• payment.succeeded
• payment.failed
• payout.created
• payout.completed
• payout.failed
• quote.expired

Delivery & retries

• Use a 2xx response to acknowledge receipt.
• Implement idempotency on your side using event.id.