Skip to main content

Wallet Management

The Wallet Management API provides comprehensive tools for managing player wallets in your Cryptofuse system. These endpoints allow you to create, list, and manage individual wallets for your users, as well as view and transfer balances between wallets.

Multi-Tier Account Structure​

Cryptofuse uses a multi-tier account structure:

  1. Master Account: Your main tenant account that manages all funds centrally
  2. Sub-Accounts (Wallets): Individual player wallets created under your master account

This architecture provides several advantages:

  • Clear separation of player funds
  • Simplified accounting and financial management
  • Precise control over fund transfers
  • Comprehensive balance tracking

Key Features​

  • Wallet Creation: Create dedicated wallets for individual players
  • Wallet Management: List, retrieve, and monitor wallets
  • Balance Viewing: View balances for specific wallets
  • Fund Transfers: Move funds between master account and player wallets
  • Payment Processing: Process payments directly from player wallets

API Endpoints​

Wallet Management​

GET /wallets                    - List all wallets
POST /wallets                   - Create a new wallet
GET /wallets/{wallet_id}        - Get wallet details ##TODO CHANGE_TO POST with wallet_id in body
GET /wallets/{wallet_id}/balances - Get wallet balances

Fund Transfers​


POST /wallets/payment/            - Create payment from wallet
POST /wallets/transfer-to-user/   - Transfer funds from master account to wallet
POST /wallets/withdraw-to-master/ - Transfer funds from wallet to master account

Next Steps​

iGaming Integration Note​

For iGaming platforms, the wallet management system forms the foundation of your player account structure. When a player registers on your platform, create a dedicated wallet for them using the /wallets endpoint. Then, use the fund transfer endpoints to move cryptocurrencies between your master account and player wallets as needed for deposits, gameplay, and withdrawals.

This structure allows you to:

  1. Maintain proper separation of player funds
  2. Track individual player balances accurately
  3. Process deposits and withdrawals efficiently
  4. Maintain a clear audit trail of all transactions

Refer to the iGaming Integration Guide for a complete workflow on implementing Cryptofuse in an iGaming environment.