Webhooks

VenPays sends signed HTTPS POSTs to your endpoints when payments and subscription charges complete or fail.

Configure

1. Dashboard → Webhooks (website profile)
2. Add an HTTPS URL (HTTP only if explicitly allowed by platform config)
3. Subscribe to events
4. Store the signing secret (whsec_...)
5. Optionally verify the URL handshake

Delivery is performed by the Payment Engine. The platform stores configuration and delivery logs and can replay a delivery.

Your receiver checklist

1. Read raw body bytes
2. Verify X-VenPays-Signature (guide)
3. Switch on event type
4. Idempotently process id
5. Return 2xx quickly

See Events and Retries.