This page describes the webhook payloads associated with the lifecycle events.
Internal wallet
Lifecycle
flowchart TD
A[<a href="#internal_wallet_A">Created</a>]
Payload
Internal wallet created
{
"event": {
"orgId": 22959,
"entity": "InternalWallets",
"eventType": "CREATE",
"numRetries": 0,
"createdAt": "2025-11-11T11:20:14.419Z",
"updatedAt": "2025-11-11T11:20:14.419Z"
},
"data": {
"orgUserId": "lestrade.1762852159",
"counterPartyId": "dr.watson.1762854189",
"walletType": "INTERNAL",
"purpose": "DEPOSIT",
"walletId": "b03d3fa8-7a15-4901-b2d7-753e029779bf",
"owner": "THIRD_PARTY",
"status": "APPROVED",
"createdAt": "2025-11-11T11:20:14.294Z",
"updatedAt": "2025-11-11T11:20:14.294Z",
"walletDetails": {
"address": "0x1E894553eAE87E706F9DFB9F236cc236169a53E7",
"currency": "USDC",
"chain": "ETHEREUM",
"network": "SEPOLIA",
"memo": "",
"nickname": null
}
}
}External wallet
Lifecycle
flowchart TD
A[<a href="#external_wallet_A">Created</a>]
B[<a href="#external_wallet_B">Screening passed</a>]
C[<a href="#external_wallet_C">Active</a>]
A --> B
B --> C
Payload
External wallet created
{
"event": {
"orgId": 22959,
"entity": "ExternalWallets",
"eventType": "WHITELISTING_REQUEST_INITIATED",
"numRetries": 0,
"createdAt": "2025-11-11T11:22:22.862Z",
"updatedAt": "2025-11-11T11:22:22.862Z"
},
"data": {
"orgUserId": "lestrade.1762852159",
"counterPartyId": "dr.watson.1762854189",
"walletType": "EXTERNAL",
"purpose": "WITHDRAWAL",
"walletId": "dcfbe88e-fdcf-4609-8bdf-01bfa21625f1",
"owner": "THIRD_PARTY",
"status": "INITIATED",
"createdAt": "2025-11-11T11:22:22.655Z",
"updatedAt": "2025-11-11T11:22:22.655Z",
"walletDetails": {
"address": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b",
"currency": "USDT",
"chain": "ETHEREUM",
"network": "SEPOLIA",
"memo": "",
"nickname": ""
}
}
}External wallet screening passed
{
"event": {
"orgId": 22959,
"entity": "ExternalWallets",
"eventType": "WHITELISTING_REQUEST_PROCESSED",
"numRetries": 0,
"createdAt": "2025-11-11T11:22:33.122Z",
"updatedAt": "2025-11-11T11:22:33.122Z"
},
"data": {
"orgUserId": "lestrade.1762852159",
"counterPartyId": "dr.watson.1762854189",
"walletType": "EXTERNAL",
"purpose": "WITHDRAWAL",
"walletId": "dcfbe88e-fdcf-4609-8bdf-01bfa21625f1",
"owner": "THIRD_PARTY",
"status": "SCREENING_PASSED",
"createdAt": "2025-11-11T11:22:22.655Z",
"updatedAt": "2025-11-11T11:22:33.027Z",
"walletDetails": {
"address": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b",
"currency": "USDT",
"chain": "ETHEREUM",
"network": "SEPOLIA",
"memo": "",
"nickname": ""
}
}
}External wallet active
{
"event": {
"orgId": 22959,
"entity": "ExternalWallets",
"eventType": "WHITELISTING_REQUEST_PROCESSED",
"numRetries": 0,
"createdAt": "2025-11-11T11:22:34.653Z",
"updatedAt": "2025-11-11T11:22:34.653Z"
},
"data": {
"orgUserId": "lestrade.1762852159",
"counterPartyId": "dr.watson.1762854189",
"walletType": "EXTERNAL",
"purpose": "WITHDRAWAL",
"walletId": "dcfbe88e-fdcf-4609-8bdf-01bfa21625f1",
"owner": "THIRD_PARTY",
"status": "APPROVED",
"createdAt": "2025-11-11T11:22:22.655Z",
"updatedAt": "2025-11-11T11:22:34.552Z",
"walletDetails": {
"address": "0x5A047dAc44Da3fd4dc7C038aCFD952C70D41781b",
"currency": "USDT",
"chain": "ETHEREUM",
"network": "SEPOLIA",
"memo": "",
"nickname": ""
}
}
}