Skip to main content

How it works

When something happens in the account, DoglyTdc Pay makes a JSON POST to each active webhook subscribed to that event.
Screenshot: Webhooks in DoglyTdc Pay

Webhooks in DoglyTdc Pay

Events

Delivery format

Headers for every delivery:

Validating the origin

The signature is a hex-encoded HMAC-SHA256 of "<timestamp>.<raw body>" using your secret (whsec_…).
Compute over the raw body, before parsing to JSON, and reject deliveries older than 5 minutes.

Retries

Respond with 2xx within 10 seconds. Any other response, redirect, or network failure is retried: After 7 attempts, the delivery is marked as failed. Test events are not retried.

Endpoint rules

  • Only https:// on a public domain; redirects are not followed.
  • Respond quickly and process in the background.
  • Use X-DoglyPay-Delivery to ignore duplicate deliveries.