Skip to main content
Webhooks push event notifications to your server the moment something happens — no polling needed. Configure a single HTTPS endpoint to receive all events, then filter by event.type in your handler.
All webhook requests from Yativo include an X-Yativo-Signature header. Always verify this signature before processing any event.

Set Webhook URL

string
required
Your HTTPS endpoint that will receive webhook events.

Get Webhook Configuration


Update Webhook URL

string
required
The webhook ID returned when the webhook was created.
string
required
New destination URL.

Webhook Event Types

Your endpoint receives POST requests with a JSON body containing an event.type field.

Event Payloads

deposit.created

deposit.updated

payout.updated

customer.created

virtual_account.deposit


Verifying Webhook Signatures

Every webhook request includes an X-Yativo-Signature header containing an HMAC SHA256 hex digest of the raw request body, signed with your webhook secret. Always verify this before trusting the payload. The signature is computed as:
Your webhook secret is available in your dashboard under Developer → Webhooks.
Never process a webhook event without first verifying its signature. Skipping this step exposes your endpoint to spoofed events.

Verification examples

Always use constant-time comparison (crypto.timingSafeEqual, hmac.compare_digest, hash_equals, etc.) — never a plain === or ==. Regular string comparison is vulnerable to timing attacks.
Use the raw request body bytes to compute the signature — not a re-serialized version of the parsed JSON. Parsing and re-stringifying can change whitespace or key order, causing signature mismatches.

Webhook Handler Example

Node.js (Express)
Respond with a 2xx status within 10 seconds to acknowledge receipt. Failed deliveries are retried automatically.

Event Log

Retrieve all webhook events sent to your endpoint:
number
Results per page.

Get Single Event


API Request Logs

Audit all API calls made against your account:
string
Filter by HTTP status code (e.g. 200, 400).
string
Filter by HTTP method (GET, POST, PUT, DELETE).
number
Page number.
number
Results per page.