THE RECEIPT
Bullring delivers webhooks through Convoy. Every request includes:
Verification algorithm
- Read
X-BULLRING-SIGNATURE. - Split the header by commas.
- Extract the
ttimestamp andv1hash. - Serialize the request payload exactly as received by your webhook framework.
- Compute:
- Compare the generated value with
v1using a constant-time comparison. - Reject stale timestamps according to your replay window.
- Return a
2xxonly after verification and durable acceptance.
Node.js example
Delivery behavior
- Convoy retries deliveries that do not receive a
2xxresponse. - 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.