Real-time event notifications and official client libraries.
Webhooks push event data to your server in real time. No polling required — get instant notifications when transactions change state.
escrow.created
New escrow transaction created
escrow.funded
Buyer funded the escrow
escrow.released
Funds released to seller
escrow.cancelled
Transaction cancelled
escrow.disputed
Dispute raised by either party
milestone.approved
Milestone payment approved
milestone.released
Milestone funds released
{
"event": "escrow.released",
"timestamp": "2026-09-10T14:32:00Z",
"data": {
"id": "esc_8x7k2m9p",
"amount": 250000,
"currency": "NGN",
"buyer_email": "buyer@example.com",
"seller_email": "seller@example.com",
"status": "released"
}
}Install the VetandPay SDK and start integrating in minutes.
composer require vetandpay/php-sdk
npm install @vetandpay/sdk
pip install vetandpay
gem install vetandpay
Add your webhook URL in the Developer Dashboard or via the API. You can register multiple endpoints.
Every webhook includes an X-VetandPay-Signature header. Verify it using your webhook secret to ensure authenticity.
Process the event payload in your application. Respond with a 2xx status code within 10 seconds.
Failed deliveries are retried up to 5 times with exponential backoff (1min, 5min, 30min, 2hr, 24hr).
Security Tip: Always verify the webhook signature before processing any event. This prevents spoofed requests from triggering actions on your server.
Our developer support team can help you get set up quickly.