API Guides
Wallet Verification Flow
Step-by-step guide to adding, verifying, and approving recipient wallets
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Step-by-step guide to adding, verifying, and approving recipient wallets
const wallet = await tokuAPI('POST', 'addWallet', {
name: 'Primary ETH Wallet',
walletAddress: '0x1234567890abcdef1234567890abcdef12345678',
network: 'Ethereum',
orgNetworkID: 'network-uuid', // from getNetworksNew
tokenTypeID: 'token-type-uuid' // from getTokenTypesNew
});
// Returns: { walletID: "..." }
await tokuAPI('POST', 'sendTestTransaction', {
walletID: wallet.walletID
});
// Check for wallets pending approval
const pending = await tokuAPI('GET', 'getTestTxnApprovalPendingWallets');
await tokuAPI('POST', 'approveWalletRequest', {
walletRequestID: 'request-uuid',
verifiedAmount: '0.001' // optional: amount the recipient confirmed
});
// Wallet status → CURRENT (active for distributions)
// 1. Bulk upload wallets
await tokuAPI('POST', 'bulkUploadMultipleWallets', {
wallets: [
{ recipientID: 'role-1', walletAddress: '0xabc...', networkName: 'Ethereum', walletType: 'Hot Wallet' },
{ recipientID: 'role-2', walletAddress: '0xdef...', networkName: 'Ethereum', walletType: 'Hot Wallet' }
]
});
// 2. Send test transactions in bulk
await tokuAPI('POST', 'processBulkTestTransactions', {
walletIDs: ['wallet-1', 'wallet-2'],
walletNetworkName: 'Ethereum'
});
// Reject the wallet
await tokuAPI('POST', 'rejectWalletRequest', {
walletRequestID: 'request-uuid'
});
// Status → REJECTED
// Deactivate (move to historical)
await tokuAPI('POST', 'markWalletAsNotCurrent', {
walletID: 'wallet-uuid'
});
// Status → ARCHIVED
// Reactivate
await tokuAPI('POST', 'reactivateWallet', {
walletID: 'wallet-uuid'
});
// Status → CURRENT
| Endpoint | Returns |
|---|---|
getAllWallets | All wallets across all recipients |
getEmployeeWallets | Current wallets for one employee |
getEmployeeHistoricalWallets | Archived wallets for one employee |
getPendingWallets | Wallets awaiting verification |
getPendingWalletRequests | All pending wallet requests |
getTestTxnApprovalPendingWallets | Wallets with confirmed test txns awaiting admin approval |
getVerifiedWalletTestRequests | Verified wallet requests |
getPendingWalletTestRequests | Unconfirmed test transactions |
await tokuAPI('POST', 'resendTestTxnEmailToWalletOwner', {
walletID: 'wallet-uuid'
});
