💱 Currency Management Overview
Support multiple currencies to serve customers worldwide. Users can view prices in their preferred currency, while all transactions are processed in your base currency.
How Multi-Currency Works
The platform uses a base currency system with automatic conversion:
- Base Currency: All prices are stored in your base currency (usually USD)
- Display Currency: Users can select their preferred currency for viewing prices
- Automatic Conversion: Prices are converted using exchange rates you define
- Payment Processing: Actual payments may occur in local currencies depending on the payment gateway
Accessing Currency Settings
Navigate to Admin Panel → Settings → Currency Settings tab.
Pre-configured Currencies
The platform comes with several popular currencies pre-configured:
USD - US Dollar
Symbol: $
Default base currency
EUR - Euro
Symbol: €
European Union
GBP - British Pound
Symbol: £
United Kingdom
NGN - Nigerian Naira
Symbol: ₦
Nigeria
INR - Indian Rupee
Symbol: ₹
India
ZAR - South African Rand
Symbol: R
South Africa
➕ Adding a New Currency
Add support for additional currencies to serve more markets.
Steps to Add a Currency
Open Currency Settings
Go to Admin Panel → Settings → Currency Settings.
Click "Add Currency"
Click the "Add Currency" button to open the currency creation form.
Fill in Currency Details
Enter the required information:
| Field | Description | Example |
|---|---|---|
| Currency Code | 3-letter ISO 4217 code | CAD |
| Currency Name | Full display name | Canadian Dollar |
| Symbol | Currency symbol | C$ or $ |
| Flag Code | 2-letter country code for flag | CA |
| Exchange Rate | Rate relative to base currency | 1.35 (1 USD = 1.35 CAD) |
| Decimal Places | Number of decimal digits | 2 |
| Decimal Separator | Character for decimals | . (dot) |
| Thousand Separator | Character for thousands | , (comma) |
Set Status
Configure the currency status:
- Is Active: Whether users can select this currency
- Is Default: Set as the default display currency for new visitors
Save the Currency
Click "Create Currency" to add it to your platform.
- USD - US Dollar | EUR - Euro | GBP - British Pound
- CAD - Canadian Dollar | AUD - Australian Dollar
- JPY - Japanese Yen | CNY - Chinese Yuan
- INR - Indian Rupee | BRL - Brazilian Real
- NGN - Nigerian Naira | KES - Kenyan Shilling
- ZAR - South African Rand | GHS - Ghanaian Cedi
📊 Managing Exchange Rates
Keep your currency exchange rates up to date to ensure accurate pricing for international customers.
Understanding Exchange Rates
Exchange rates in the system are relative to your base currency. If USD is your base:
- USD = 1.00 (always 1 for base currency)
- EUR = 0.92 (means 1 USD = 0.92 EUR)
- GBP = 0.79 (means 1 USD = 0.79 GBP)
- NGN = 1500.00 (means 1 USD = 1500 NGN)
Updating Exchange Rates
Go to Currency Settings
Navigate to Admin Panel → Settings → Currency Settings.
Find the Currency
Locate the currency you want to update in the list.
Click Edit
Click the Edit button for that currency.
Update the Exchange Rate
Enter the new exchange rate value.
Save Changes
Click "Update Currency" to save.
Where to Get Exchange Rates
You can find current exchange rates from:
- XE.com - Real-time exchange rates
- Google Finance - Search "1 USD to EUR"
- OANDA - Currency converter
- Your bank's published rates
Setting the Default Currency
To change which currency visitors see by default:
- Go to Currency Settings
- Find the currency you want as default
- Click the "Set as Default" button or star icon
- The currency will be marked with a default indicator
📦 Subscription Management
View and manage active subscriptions, handle refunds, and monitor subscription health.
Accessing Subscriptions
Navigate to Admin Panel → Subscriptions from the sidebar.
Subscription Information
For each subscription, you can view:
- User: Subscriber name and email
- Package: Subscribed plan name
- Status: Active, Expired, Cancelled, or Pending
- Start Date: When subscription began
- End Date: When subscription expires
- Payment Gateway: Which gateway processed the payment
- Amount Paid: Payment amount and currency
Subscription Statuses
| Status | Meaning | User Access |
|---|---|---|
| ● Active | Subscription is current and valid | Full access to package features |
| ● Pending | Payment processing or awaiting confirmation | Limited or no access |
| ● Expired | Subscription period has ended | Access reverted to free tier |
| ● Cancelled | User or admin cancelled the subscription | Access until end of paid period |
Managing Subscriptions
Extending a Subscription
If you need to extend a user's subscription (e.g., for a goodwill gesture):
- Find the subscription in the list
- Click the Edit button
- Modify the End Date to the new expiration date
- Save changes
Cancelling a Subscription
To cancel a subscription:
- Find the subscription in the list
- Click Cancel or change status to Cancelled
- Confirm the action
Note: The user retains access until their paid period ends.
💳 Transaction History
Monitor all payment transactions processed through your platform.
Viewing Transactions
Navigate to Admin Panel → Payments to view transaction history.
Transaction Details
Each transaction record includes:
- Transaction ID: Unique identifier from payment gateway
- User: Who made the payment
- Amount: Payment amount and currency
- Gateway: Which payment provider processed it
- Status: Success, Failed, Pending, or Refunded
- Date: When the transaction occurred
- Package: What package was purchased
Transaction Statuses
| Status | Description | Action Required |
|---|---|---|
| ✓ Success | Payment completed successfully | None - subscription activated |
| ⏳ Pending | Payment initiated but not confirmed | Wait for gateway confirmation |
| ✗ Failed | Payment was declined or errored | Contact user if needed |
| ↩ Refunded | Payment was refunded to customer | Subscription may be cancelled |
Processing Refunds
To process a refund:
- Refunds must be processed directly through your payment gateway dashboard (Stripe, PayPal, etc.)
- Update the transaction status in the admin panel if needed
- Cancel or modify the associated subscription
- Notify the customer about the refund