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
CryptoDepositFundsReceivedFunds received for crypto deposit session

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": "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": "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": "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    "idempotencyKey": "merchant-withdrawal-12345"
16  }
17}
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    "idempotencyKey": "merchant-withdrawal-12345"
16  }
17}
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    "idempotencyKey": "merchant-withdrawal-12345"
16  }
17}

🪙 Crypto Deposit Events

CryptoDepositFundsReceived
1{
2  "eventType": "CryptoDepositFundsReceived",
3  "category": "CryptoDeposit",
4  "created": "2024-01-01T00:00:00.000Z",
5  "data": {
6    "sessionId": "session-123",
7    "depositAddress": "deposit-address-here",
8    "blockchainChainId": "solana",
9    "blockchainName": "Solana",
10    "tokenSymbol": "USDC",
11    "user": "user-456",
12    "amount": {
13      "cents": 10000,
14      "currency": "USD"
15    },
16    "merchantId": "merchant-789",
17    "transactionHash": "tx-hash-here",
18    "receivedAt": "2024-01-01T00:00:00.000Z"
19  }
20}

Description

This webhook is sent when a crypto deposit transaction has been successfully processed and funds have been received. It includes details about the deposit address, blockchain information, token details, and the amount received.

The amount field contains the received amount in cents with USD currency.

Use Cases

  • Confirming successful crypto deposits
  • Updating user balances
  • Triggering downstream processes like withdrawals
  • Recording transaction history