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 receivesPOST 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 anX-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:
Verification examples
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.

