Skip to main content

Wallet Overview

The BingBang wallet system provides a secure and flexible way to manage funds for gaming activities.

Features​

Multi-Currency Support​

  • Multiple currency balances
  • Automatic currency conversion
  • Preferred currency settings
  • Real-time balance updates
  • Supported currencies:
    • KSH (Kenyan Shilling) - KSh
    • NGN (Nigerian Naira) - ₦
    • GHS (Ghanaian Cedi) - ₵
    • USD (US Dollar) - $
    • ZAR (South African Rand) - R

Transaction Types​

type TransactionType = 
  | "Deposit"           // Adding funds to wallet
  | "Ticket Purchase"   // Buying game tickets
  | "Payout"           // Winning game prizes
  | "Fee Deduction"     // Platform and host fees
  | "Refund"           // Game cancellation refunds
  | "Game Creation Fee" // Creating new games

Payment Status​

type PaymentStatus = 
  | "Pending"    // Transaction initiated
  | "Completed"  // Transaction successful
  | "Failed"     // Transaction failed

Wallet Structure​

User Wallet​

{
  id: string;              // User ID
  preferred_currency: string; // Default currency (KSH, NGN, GHS, USD, ZAR)
  wallet_balance: number;   // Current balance
  currency_balances: {      // Multi-currency balances
    id: string;            // Balance record ID
    currency_code: string; // Currency type
    balance: number;       // Balance amount
  }[]
}

Platform Accounts​

{
  id: string;              // Account ID
  currency_code: string;   // Currency type
  balance: number;         // Platform balance
}

Key Functions​

Balance Management​

  • Get wallet balance
  • Update balance
  • Check currency balances
  • Process refunds
  • Minimum balance requirements:
    • Minimum deposit: 100 KSH/NGN/GHS
    • Minimum withdrawal: 500 KSH/NGN/GHS
    • Minimum balance to host: 100 KSH/NGN/GHS
  • Negative balance prevention
  • Balance validation

Transaction Handling​

  • Record transactions
  • Track payment status
  • Handle refunds
  • Process payouts
  • Fee structure:
    • Platform fee: 1%
    • Host fee: 0-5%
    • Creation fee: 5%
    • Currency conversion: 1%
  • Transaction types:
    • Deposits
    • Ticket purchases
    • Game payouts
    • Fee deductions
    • Refunds
    • Game creation fees

Security Features​

  • Transaction verification
  • Balance validation
  • Negative balance prevention
  • Audit trail
  • Fraud detection
  • Suspicious activity monitoring
  • Mobile money verification
  • Bank account verification
  • Payment provider validation

Best Practices​

For Users​

  • Keep track of transactions
  • Monitor balance changes
  • Verify payment status
  • Report issues promptly
  • Maintain minimum balance for hosting
  • Verify payment details
  • Keep transaction receipts

For Hosts​

  • Monitor revenue
  • Track fees
  • Verify payouts
  • Handle refunds
  • Maintain minimum balance
  • Track game fees
  • Monitor payouts

For Admins​

  • Monitor transactions
  • Review balances
  • Handle disputes
  • Maintain security
  • Track platform fees
  • Verify transactions
  • Handle refunds

Common Questions​

How do I check my balance?​

  • View wallet dashboard
  • Check transaction history
  • Monitor currency balances
  • Review recent activity
  • Real-time updates
  • Balance notifications

What happens to my funds?​

  • Secure storage
  • Real-time updates
  • Transaction tracking
  • Balance verification
  • Minimum balance requirements
  • Negative balance prevention
  • Fee tracking

How are refunds handled?​

  • Automatic processing
  • Balance restoration
  • Transaction recording
  • Status updates
  • Fee refunds
  • Game cancellation refunds
  • Failed transaction refunds

Next Steps​