Webhooks
Real-time payment notifications
Webhooks let your server receive HTTP callbacks when a payment’s state changes, so you do not have to poll for every update.
Overview
- Configure a webhook URL in the SenjaroPay dashboard (HTTPS recommended).
- SenjaroPay sends
POSTrequests to that URL when relevant events occur (for example payment completed or failed). - Your endpoint verifies the request (signature or shared secret, if provided by the API) and updates your systems.
Payload
Event bodies are JSON. They typically include the payment identifier, status, and amount. Document the exact schema to match your production implementation.
Response and retries
Return HTTP 2xx quickly to acknowledge delivery. If your endpoint errors or times out, SenjaroPay may retry with backoff—configure idempotent handlers so duplicate deliveries do not double-charge or double-fulfill.
Security
- Use HTTPS only.
- Validate signatures or secrets on every request before trusting the body.
- Treat webhook payloads as hints; optionally confirm critical state with the payment status API before irreversible actions.