Developer ResourcesWebhooks

Withdraw Webhooks

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

Webhooks may be sent more than once—add deduplication logic to prevent duplicate events.

✅ 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

KYC Created
1{
2  "eventType": "KYC Created",
3  "category": "KYC",
4  "created": "2025-04-08T16:26:32.109Z",
5  "data": {
6    "wallet": "testtestʬtest-withdrawer-f",
7    "blockchain": "user",
8    "email": "testwithdrawer-f@gmail.com"
9  }
10}
KYC Success
1{
2  "eventType": "KYC Success",
3  "category": "KYC",
4  "created": "2025-04-08T16:26:33.520Z",
5  "data": {
6    "wallet": "testtestʬtest-withdrawer-f",
7    "blockchain": "user",
8    "email": "testwithdrawer-f@gmail.com"
9  }
10}
KYC Failure
1{
2  "eventType": "KYC Failure",
3  "category": "KYC",
4  "created": "2025-04-09T20:45:24.515Z",
5  "data": {
6    "wallet": "testtestʬtest-f",
7    "blockchain": "user",
8    "email": "test-f@gmail.com "
9  }
10}

💸 Withdraw Events

Withdraw Pending
1{
2  "eventType": "Withdraw Pending",
3  "category": "Withdraw",
4  "created": "2025-04-08T17:05:56.718Z",
5  "data": {
6    "wallet": "9ATzQ4yKLYBrqMvkWQTzL8tmNVuBSkYoM1RtKo7HPk6n",
7    "blockchain": "solana",
8    "signature": "5nQq5iVkoEc1gomDENhVNkYVXA61kzjsXKiZiAm6iq36wX3auEdrN1jZBAE5mggZWRbTvfRw5AAiVJ2ah6TaRMXS",
9    "userFees": { "cents": 200, "currency": "USD" },
10    "userGasFees": { "cents": 0, "currency": "USD" },
11    "merchantGasFees": { "cents": 2, "currency": "USD" },
12    "total": { "cents": 202, "currency": "USD" },
13    "currency": "USD",
14    "merchantId": "testtest"
15  }
16}
Withdraw Success
1{
2  "eventType": "Withdraw Success",
3  "category": "Withdraw",
4  "created": "2025-04-08T17:06:05.177Z",
5  "data": {
6    "wallet": "user123",
7    "blockchain": "solana",
8    "signature": "5nQq5iVkoEc1gomDENhVNkYVXA61kzjsXKiZiAm6iq36wX3auEdrN1jZBAE5mggZWRbTvfRw5AAiVJ2ah6TaRMXS",
9    "userFees": { "cents": 200, "currency": "USD" },
10    "userGasFees": { "cents": 0, "currency": "USD" },
11    "merchantGasFees": { "cents": 2, "currency": "USD" },
12    "total": { "cents": 202, "currency": "USD" },
13    "currency": "USD",
14    "merchantId": "testtest"
15  }
16}
Withdraw Failure
1{
2  "eventType": "Withdraw Failure",
3  "category": "Withdraw",
4  "created": "2025-04-08T17:07:05.177Z",
5  "data": {
6    "wallet": "user123",
7    "blockchain": "solana",
8    "signature": "5nQq5iVkoEc1gomDENhVNkYVXA61kzjsXKiZiAm6iq36wX3auEdrN1jZBAE5mggZWRbTvfRw5AAiVJ2ah6TaRMXS",
9    "userFees": { "cents": 200, "currency": "USD" },
10    "userGasFees": { "cents": 0, "currency": "USD" },
11    "merchantGasFees": { "cents": 2, "currency": "USD" },
12    "total": { "cents": 202, "currency": "USD" },
13    "currency": "USD",
14    "merchantId": "testtest"
15  }
16}