Skip to main content

Overview

Configure a Webhook URL in your Developer Dashboard to receive signed HTTP POST notifications whenever a transaction status changes to success or failed.
Webhooks are far more efficient than polling /requery. Set one up before going live.

Webhook Payload

Status Values


Verifying Signatures

Every webhook is signed using HMAC SHA-512. You must verify this signature to ensure the request is genuinely from RapidTopup. Steps:
  1. Get your Webhook Secret from the Developer Dashboard
  2. Read the raw request body as a string (before JSON parsing)
  3. Compute HMAC-SHA512(raw_body, webhook_secret)
  4. Compare to the X-RapidTopup-Signature header using constant-time comparison

Retry Policy

If your server returns a non-2xx response or times out after 10 seconds, we retry with exponential backoff:
Always return HTTP 200 OK from your webhook endpoint immediately, even if you’re processing the event asynchronously in a queue. Otherwise we’ll treat it as a failure and keep retrying.