Webhooks

Overview

Webhooks, or callbacks, are POST requests sent from Vaultody to your specified URL when subscribed events occur. This mechanism allows real-time notifications for events such as transaction requests, approvals, rejections, and incoming transactions.

Setting Up Webhooks

1. Navigate to Developers Section: In the Dashboard, go to the Developers menu and select Webhooks.
2. Add a New Webhook Endpoint: Click the "Add Endpoint" button and enter your desired callback URL.
3. Authenticate the Request: Set a secret for your webhook to ensure secure communication.
4. Select Events: Choose the events you wish to subscribe to for notifications.

Example Payloads

Transaction Request

{
  "walletId": "64463ff167ecf9000707b052",
  "webhookId": "65b2633879435ab2f30727ff",
  "idempotencyKey": "uniqueKey",
  "apiVersion": "2023-04-20",
  "data": {
    "event": "TRANSACTION_REQUEST",
    "item": {
      "blockchain": "tron",
      "network": "nile",
      "requestId": "65e89fd7e7684b8228dec633"
    }
  }
}

Transaction Approved

{
  "walletId": "64463ff167ecf9000707b052",
  "webhookId": "65b2633879435ab2f30727ff",
  "idempotencyKey": "uniqueKey",
  "apiVersion": "2023-04-20",
  "data": {
    "event": "TRANSACTION_APPROVED",
    "item": {
      "blockchain": "tron",
      "network": "nile",
      "requestId": "65e89fd7e7684b8228dec633",
      "requiredApprovals": 1,
      "requiredRejections": 1,
      "currentApprovals": 1,
      "currentRejections": 0
    }
  }
}

Need Help?

For additional support, visit our Help Center.