How webhooks work
1. Event occurs
A payment collection, disbursement, or other transaction changes status.
2. MarzPay sends POST
MarzPay sends an HTTP POST request to your configured webhook URL with event data.
3. You acknowledge
Your server responds with HTTP 200 to confirm receipt.
4. You process
Update your database, fulfill orders, or send notifications based on the event.
Configure webhooks
- Log in to the MarzPay Dashboard
- Go to Settings > Webhooks
- Add your webhook endpoint URL (must use HTTPS)
- Select the events you want to receive
- Copy your webhook signing secret
Webhook events
Webhook payload example
Verify webhook signatures
Verify webhook signatures to ensure the request came from MarzPay:Always verify webhook signatures. Never trust webhook payloads without verification, as attackers could send fake requests to your endpoint.
Webhook retry policy
If your endpoint does not return HTTP 200, MarzPay will retry with exponential backoff:
After 5 failed attempts, the webhook is disabled and you will receive an alert in the Dashboard.
API Playground - Webhooks - Test webhook endpoints live

