Receiving and verifying real-time event notifications.
Dexxify notifies your backend the moment something happens — a deposit lands, a payment completes, a payout succeeds or fails, a swap finishes, a refund processes.
Registering an endpoint
PUT /webhooks
{ "url": "https://yourapp.com/webhooks/dexxify"}
One endpoint per environment — registering again for the same mode replaces the existing URL. Fetch or remove it with:
GET /webhooksDELETE /webhooks
Verifying a webhook
Every request Dexxify sends carries three headers:
Header
Meaning
X-Dexxify-Signature
HMAC-SHA256 of the raw request body, using your endpoint’s signing secret
X-Dexxify-Event
The event type, e.g. deposit.completed
X-Dexxify-Delivery
A unique ID for this delivery attempt, for idempotency/dedup
Compute the HMAC over the raw request body, not a re-serialized JSON object — re-serializing can change key order or whitespace and break the signature check.
Get or regenerate your signing secret:
POST /webhooks/regenerate-secret
Regenerating invalidates the old secret immediately. Any in-flight deliveries signed with the previous secret will fail verification on your end.