Withdraw Webhooks

Developers can use this documentation to listen to webhooks associatied with KYC/B and Withdrawals.

Event Types

Event TypeDescription
KYC CreatedKYC process has started
KYC SuccessKYC passed
KYC FailureKYC failed
Withdraw PendingWithdrawal has been initiated
Withdraw SuccessWithdrawal submitted to the bank
Withdraw FailureWithdrawal failed

Sample Webhook Payloads

🧾 KYC Events


{
  "eventType": "KYC Created",
  "category": "KYC",
  "created": "2025-04-08T16:26:32.109Z",
  "data": {
    "wallet": "testtestʬtest-withdrawer-f",
    "blockchain": "user",
    "email": "[email protected]"
  }
}
{
  "eventType": "KYC Success",
  "category": "KYC",
  "created": "2025-04-08T16:26:33.520Z",
  "data": {
    "wallet": "testtestʬtest-withdrawer-f",
    "blockchain": "user",
    "email": "[email protected]"
  }
}
{
  "eventType": "KYC Failure",
  "category": "KYC",
  "created": "2025-04-09T20:45:24.515Z",
  "data": {
    "wallet": "testtestʬtest-f",
    "blockchain": "user",
    "email": "[email protected] "
  }
}

💸 Withdraw Events

{
  "eventType": "Withdraw Pending",
  "category": "Withdraw",
  "created": "2025-04-08T17:05:56.718Z",
  "data": {
    "wallet": "9ATzQ4yKLYBrqMvkWQTzL8tmNVuBSkYoM1RtKo7HPk6n",
    "blockchain": "solana",
    "signature": "5nQq5iVkoEc1gomDENhVNkYVXA61kzjsXKiZiAm6iq36wX3auEdrN1jZBAE5mggZWRbTvfRw5AAiVJ2ah6TaRMXS",
    "userFees": { "cents": 200, "currency": "USD" },
    "userGasFees": { "cents": 0, "currency": "USD" },
    "merchantGasFees": { "cents": 2, "currency": "USD" },
    "total": { "cents": 202, "currency": "USD" },
    "currency": "USD",
    "merchantId": "testtest"
  }
}
{
  "eventType": "Withdraw Success",
  "category": "Withdraw",
  "created": "2025-04-08T17:06:05.177Z",
  "data": {
    "wallet": "user123",
    "blockchain": "solana",
    "signature": "5nQq5iVkoEc1gomDENhVNkYVXA61kzjsXKiZiAm6iq36wX3auEdrN1jZBAE5mggZWRbTvfRw5AAiVJ2ah6TaRMXS",
    "userFees": { "cents": 200, "currency": "USD" },
    "userGasFees": { "cents": 0, "currency": "USD" },
    "merchantGasFees": { "cents": 2, "currency": "USD" },
    "total": { "cents": 202, "currency": "USD" },
    "currency": "USD",
    "merchantId": "testtest"
  }
}
{
  "eventType": "Withdraw Failure",
  "category": "Withdraw",
  "created": "2025-04-08T17:07:05.177Z",
  "data": {
    "wallet": "user123",
    "blockchain": "solana",
    "signature": "5nQq5iVkoEc1gomDENhVNkYVXA61kzjsXKiZiAm6iq36wX3auEdrN1jZBAE5mggZWRbTvfRw5AAiVJ2ah6TaRMXS",
    "userFees": { "cents": 200, "currency": "USD" },
    "userGasFees": { "cents": 0, "currency": "USD" },
    "merchantGasFees": { "cents": 2, "currency": "USD" },
    "total": { "cents": 202, "currency": "USD" },
    "currency": "USD",
    "merchantId": "testtest"
  }
}