Receiving Webhooks
When you create a subscription viaPOST /v1/webhooks, Kiwify sends real-time notifications to your registered HTTPS endpoint.
How it works
- An event occurs on the account (transfer completed, QR code paid, deposit received, etc.).
- The dispatcher sends an HTTP POST to your registered URL.
- Your endpoint must respond with HTTP 2xx to acknowledge receipt.
- On failure, delivery is retried automatically (duplicates are possible).
Manage subscriptions using the Webhooks endpoints in the API reference. This guide documents what you receive on your server.
Envelope format
All deliveries use the same JSON envelope:Deduplication
Do not use the envelopeid for deduplication — it changes on every retry.
Use resource identifiers inside data:
Next steps
- Event types — full subscription → delivery matrix
- Payload structures —
datafield format per event - Headers & verification — Ed25519 signature and HTTP headers