Skip to main content
Webhooks allow external systems to push event notifications to OLIVE. These endpoints receive payment confirmations, message events, and other real-time updates.

​
Features

VULT Integration

Receive cash-in notifications from VULT processor

WhatsApp Messages

Process WhatsApp messages via Agent-TS

HMAC Verification

Secure webhook payloads with signature verification

Real-time Processing

Instant event handling and response

​
Endpoints

VULT Webhook

POST /webhooks/vult/cashinReceive VULT cash-in notifications

WhatsApp Webhook

POST /api/v1/external/whatsappProcess WhatsApp messages

​
Webhook Security

All webhooks should verify the signature before processing:
  1. Extract signature from header (X-VULT-Signature or equivalent)
  2. Compute HMAC-SHA256 of the raw request body
  3. Compare signatures using timing-safe comparison
  4. Reject requests with invalid or missing signatures

​
Webhook Flow

1

Event Occurs

External system (VULT, WhatsApp) generates an event
2

Webhook Sent

System sends HTTP POST to configured endpoint with signed payload
3

Verify Signature

OLIVE verifies HMAC signature before processing
4

Process Event

Event is processed (e.g., credit wallet, respond to message)
5

Acknowledge

Return success response to confirm receipt