Wallets

The wallet feature is a core component of ColibriPlus business account functionality. Every user on the platform is automatically assigned a personal wallet upon registration.

It's important to understand that wallets operate exclusively within the ColibriPlus ecosystem and cannot be used for external payments or transactions outside the platform.

Use Cases

Users can deposit funds into their wallets to access various premium features and services throughout the platform. Common use cases include purchasing pro subscriptions, funding advertising campaigns, making in-app purchases, accessing premium content, participating in paid events, and utilizing other monetized features within the ColibriPlus ecosystem.

The wallet system creates a seamless internal economy where users can manage their spending across all platform services from a single, unified balance.

Wallet Currency

As the platform administrator, you have full control over the currency used throughout the entire wallet system. This currency setting applies universally to all users and all wallet transactions on your platform, ensuring consistency across the entire ecosystem.

To configure your platform's currency, open the .env file and set the following variable:

# Currency alpha 3 code. Example: USD, EUR, RUB, etc.
APP_DEFAULT_CURRENCY=USD

Important ⚠️

Ensure the currency you select is supported by all payment gateways enabled on your platform. Incompatible currency settings will prevent users from depositing funds into their wallets, effectively breaking the payment system.

Always clear the configuration cache after updating the .env file to ensure changes take effect immediately:

php colibri cache:clear

Transfers

Every wallet is assigned a unique identification number that serves as the transfer address. Users can easily send funds to other platform members by simply entering the recipient's wallet number. This peer-to-peer transfer system enables users to share funds between each other for different purposes.

The transfer system maintains complete transaction history and provides real-time notifications to both sender and recipient for transparency and security.

Configuration

ColibriPlus provides comprehensive wallet configuration options, allowing you to tailor the financial system to your specific business needs and regulatory requirements. You can establish minimum and maximum limits for all transaction types, set default starting balances for new users, configure commission structures for different operations, and customize the overall wallet experience.

These settings help you maintain financial control, prevent abuse, ensure compliance with local regulations, and create sustainable revenue streams through transaction fees.

Wallet Name

Customize the display name for your wallet system throughout the platform interface:

# Wallet name displayed to users
WALLET_NAME=ColibriPay

Default Balance

Set the initial balance automatically credited to new user accounts upon registration:

# Starting balance for new users (in your platform currency)
WALLET_DEFAULT_BALANCE=0

Deposit Min/Max Amounts

Configure deposit limits to control how much users can add to their wallets in a single transaction:

# Minimum deposit amount per transaction
WALLET_DEPOSIT_MIN_AMOUNT=10

# Maximum deposit amount per transaction
WALLET_DEPOSIT_MAX_AMOUNT=1000000

Transfer Min/Max Amounts

Set limits for peer-to-peer transfers between user wallets:

# Minimum transfer amount per transaction
WALLET_TRANSFER_MIN_AMOUNT=10

# Maximum transfer amount per transaction
WALLET_TRANSFER_MAX_AMOUNT=1000000

Commissions

Define percentage-based commission rates for different wallet operations to generate platform revenue:

# Commission percentage for deposits (e.g., 3 = 3%)
WALLET_COMMISSION_DEPOSIT=3

# Commission percentage for transfers between users
WALLET_COMMISSION_TRANSFER=1

# Commission percentage for withdrawals
WALLET_COMMISSION_WITHDRAW=3

Withdraw Min/Max Amounts

Control withdrawal limits to manage cash flow and prevent abuse:

# Minimum withdrawal amount per transaction
WALLET_WITHDRAW_MIN_AMOUNT=10

# Maximum withdrawal amount per transaction
WALLET_WITHDRAW_MAX_AMOUNT=1000000