Webhooks

Receive real-time server-to-server notifications when payout status changes.

Payout Events

Webhook Payload

{
  "event": "payout.success",
  "reference_id": "PAY-2024-001",
  "payout_id": "POXXXXXXXXXXXX",
  "amount": 1000,
  "platform_fee": 15,
  "total_debited": 1015,
  "status": "success",
  "utr": "123456789012",
  "timestamp": "2024-06-02T14:35:00+00:00"
}

Signature Verification

Verify X-Webhook-Signature header — HMAC-SHA256 of JSON payload using your API Key.

$expected = hash_hmac('sha256', $payload, 'SVX_your_api_key');
if (!hash_equals($expected, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'])) {
    http_response_code(401); exit;
}