Webhooks
Configure a webhook URL to receive real-time HTTP POST notifications when events occur on your account.
Supported events
Webhook payload
Requirements
- URL must use HTTPS
- Must respond with
2xx status within 10 seconds
- Failed deliveries are retried up to 3 times with exponential backoff
Verifying webhook signatures
Every webhook request includes an X-Webhook-Signature header containing an HMAC-SHA256 signature. Use this to verify that the request is from TronRental.
The signature is computed over the raw request body using your webhook secret (returned when you configure your webhook).
Always verify the signature before processing webhook data. Use constant-time comparison (hmac.compare_digest / crypto.timingSafeEqual) to prevent timing attacks.
Webhook URLs cannot point to localhost, 127.0.0.1, or other private addresses.