Webhook Integration & Security
Webhooks allow your application to receive real-time asynchronous notifications whenever a payment is approved, debited, or settled.Webhook Signature Verification (HMAC-SHA512)
Every webhook request sent by Handle includes the X-Handle-Signature header:
t: UNIX timestamp (in seconds) of when the webhook was generated.v1:HMAC-SHA512(t + "." + rawBody, webhookSigningSecret).
Node.js / TypeScript Verification Code
Event Types
charge.success
Triggered immediately when the customer approves the payment and bank debit is confirmed:
Exponential Backoff Retry Policy
Handle will never flood or spam your server during outages. If your server returns anything other than200 OK, Handle retries using an exponential schedule:
- Attempt 1: Immediate ()
- Attempt 2:
- Attempt 3:
- Attempt 4:
- Attempt 5:
- Attempt 6 (Final):