A wallet is where a subscriber’s money lives. Think of it like a digital version of a bank account - it holds your balance and tracks every Leone that goes in or out.
OLIVE wallets only hold Sierra Leonean Leones (SLE). There’s no multi-currency support - everything is in Leones.This keeps things simple for users in Sierra Leone. If you receive money, it goes into your SLE balance. If you pay someone, it comes from your SLE balance.
Balances are stored as whole numbers without decimals. While the Leone doesn’t have fractional units in practice, this approach prevents floating-point errors that can occur with decimal math.
What You See
What’s Stored
1,500 SLE
1500
25,000 SLE
25000
3,500,000 SLE
3500000
This means a balance of 500000 in the database equals 500,000 Leones.
When you first register on OLIVE (via WhatsApp or through an agent), the system creates your subscriber record AND your wallet account. You start with a zero balance.
If somehow a subscriber exists without a wallet (edge case), OLIVE creates one automatically when they first receive money. This ensures nobody loses funds due to a missing account.The system runs a background job (SeedSubscriberWallets) that ensures every subscriber has a wallet.
You’ve only verified your phone number. This is the most restricted level.
Limit Type
Amount
Maximum Balance
500,000 SLE
Single Transaction
50,000 SLE
Daily Total
200,000 SLE
Monthly Total
2,000,000 SLE
Real-world impact: You can’t hold more than 500K in your wallet. If someone tries to send you 600K and you have 100K already, the transaction will fail.
OLIVE wallets cannot have negative balances. Every payment or withdrawal is validated against your current balance before execution.If you have 10,000 SLE and try to pay 15,000 SLE, the transaction fails with “insufficient balance.”
Wallet = Your money (the balance)
Card = How you access your money (the key)Think of it like:
Wallet = Bank account
Card = ATM card / Debit card
You can have multiple cards (parent + child cards) that all access the same wallet balance. The cards don’t hold money - they’re just authorization tools.
