Skip to main content

Multi-Currency Support

Learn how to manage multiple currencies in your BingBang wallet.

Currency Management​

Supported Currencies​

  • NGN (Nigerian Naira) - ₦
    • Payment methods: card, bank, ussd, qr, bank_transfer, mobile_money
  • KES (Kenyan Shilling) - KSh
    • Payment methods: card, mobile_money
  • GHS (Ghanaian Cedi) - ₵
    • Payment methods: card, bank, mobile_money
  • USD (US Dollar) - $
    • Payment methods: card
  • ZAR (South African Rand) - R
    • Payment methods: card, bank

Currency Structure​

{
  code: string;            // Currency code (e.g., KES)
  name: string;           // Currency name
  symbol: string;         // Currency symbol
  decimal_places: number; // Decimal precision
  country: string;        // Country of origin
  payment_methods: string[]; // Available payment methods
}

Balance Management​

Currency Balances​

{
  id: string;              // User ID
  currency_code: string;   // Currency type
  balance: number;         // Current balance
  preferred_currency: string; // Default currency
}

Balance Features​

  • Multiple currency balances
  • Automatic conversion
  • Real-time updates
  • Balance tracking

Platform Accounting​

Account Structure​

{
  currency_code: string;      // Currency type
  platform_balance: number;   // Platform's balance
  total_funds: number;        // Total funds in system
  user_wallets_total: number; // Total in user wallets
  users_with_balance: number; // Number of users with balance
}

Fee Tracking​

  • Platform fees by currency
  • Host fees by currency
  • Creation fees by currency
  • Transaction fees by type

Currency Operations​

Deposits​

  • Currency selection
  • Conversion rates
  • Balance updates
  • Transaction recording

Withdrawals​

  • Currency selection
  • Conversion fees
  • Balance verification
  • Transaction processing

Best Practices​

For Users​

  • Set preferred currency
  • Monitor exchange rates
  • Track currency balances
  • Review conversion fees

For Admins​

  • Monitor currency balances
  • Manage exchange rates
  • Handle conversions
  • Track currency usage

Common Questions​

How do I change my preferred currency?​

  • Profile settings
  • Currency selection
  • Balance conversion
  • Update preferences

What are the conversion fees?​

  • Platform fee: 1%
  • Currency spread
  • Bank fees
  • Processing fees

How are exchange rates handled?​

  • Real-time rates
  • Daily updates
  • Rate locking
  • Rate history

Next Steps​