Skip to main content
THE RECEIPT
Bullring delivers webhooks through Convoy. Every request includes:
The endpoint secret is returned by the dashboard when the webhook endpoint is created. Store it securely.

Verification algorithm

  1. Read X-BULLRING-SIGNATURE.
  2. Split the header by commas.
  3. Extract the t timestamp and v1 hash.
  4. Serialize the request payload exactly as received by your webhook framework.
  5. Compute:
  1. Compare the generated value with v1 using a constant-time comparison.
  2. Reject stale timestamps according to your replay window.
  3. Return a 2xx only after verification and durable acceptance.
Example header:

Node.js example

Use the raw request body when possible. If your framework parses the body first, reproduce the exact serialization used by the request before calculating the HMAC.

Delivery behavior

  • Convoy retries deliveries that do not receive a 2xx response.
  • Deduplicate events using the event ID in the payload when available.
  • Do not process the event before signature verification.
  • Do not log the webhook secret or full signature header.