Billing & Wallets

Manage your account billing, payment methods, and wallet balances across multiple currencies.

Wallet System

Multi-Currency Support

Lineserve supports multiple currencies to serve our global customer base:

USD - US Dollar (Primary)
KES - Kenyan Shilling
ZAR - South African Rand
NGN - Nigerian Naira
GHS - Ghanaian Cedi
TZS - Tanzanian Shilling

Wallet Balances

Each currency has its own wallet balance:

Available Balance: Funds available for immediate use
Pending Balance: Funds being processed or held
Reserved Balance: Funds reserved for running services

Payment Methods

Credit/Debit Cards

Supported Cards: Visa, Mastercard, American Express
Security: PCI DSS compliant processing
Auto-reload: Automatic top-up when balance is low
Saved Cards: Securely store cards for future use

Bank Transfers

Local Banks: Direct bank transfers in supported regions
Processing Time: 1-3 business days
Minimum Amount: Varies by currency
Bank Details: Provided after initiating transfer

Mobile Money

Available in select African markets:

M-Pesa (Kenya, Tanzania)
Airtel Money (Kenya, Tanzania, Uganda)
MTN Mobile Money (Uganda, Ghana)
Orange Money (Senegal, Mali)

Cryptocurrency (Coming Soon)

Bitcoin (BTC)
Ethereum (ETH)
USDC Stablecoin

Billing Cycles

Prepaid Model

Pay-as-you-go: Only pay for resources you use
No monthly fees: No base subscription costs
Instant provisioning: Resources deployed immediately
Real-time billing: Usage tracked in real-time

Billing Frequency

Hourly: VPS, databases, load balancers
Per-message: SMS and messaging services
Monthly: Reserved instances, dedicated servers
Per-GB: Storage and bandwidth usage

Auto-Reload

Configuration

Set up automatic wallet top-up to avoid service interruptions:

Threshold Amount: Minimum balance before reload
Reload Amount: How much to add to wallet
Payment Method: Which card/method to use
Maximum Frequency: Prevent excessive reloads

Example Configuration

Threshold: $10 USD
Reload Amount: $50 USD
Payment Method: Visa ending in 1234
Max Frequency: Once per day

Invoicing & Receipts

Invoice Generation

Monthly Invoices: Detailed usage breakdown
Real-time Receipts: Immediate payment confirmations
PDF Downloads: Professional invoice formatting
Email Delivery: Automatic invoice delivery

Invoice Details

Each invoice includes:

Service Usage: Detailed resource consumption
Pricing Breakdown: Cost per service/resource
Tax Information: VAT/tax calculations where applicable
Payment History: Previous payments and credits

Usage Tracking

Real-time Monitoring

Track your spending across all services:

Current Month: Month-to-date usage
Daily Breakdown: Daily spending patterns
Service Categories: Spending by service type
Resource Details: Individual resource costs

Cost Alerts

Set up alerts to monitor spending:

Budget Alerts: Notify when approaching budget limits
Unusual Activity: Alert on unexpected usage spikes
Low Balance: Warning when wallet balance is low
Service Limits: Notify when nearing service quotas

Pricing Transparency

No Hidden Fees

Transparent Pricing: All costs clearly displayed
No Setup Fees: Free account setup and configuration
No Cancellation Fees: Cancel services anytime
No Minimum Commitments: Pay only for what you use

Cost Optimization

Reserved Instances: Save up to 30% with annual commitments
Volume Discounts: Automatic discounts for high usage
Regional Pricing: Competitive local pricing
Free Tier: Generous free allowances for new users

Tax & Compliance

Tax Handling

VAT/GST: Automatically calculated where applicable
Tax Exemptions: Support for tax-exempt organizations
Regional Compliance: Compliant with local tax laws
Tax Reporting: Detailed tax information on invoices

Supported Tax Regions

Kenya: 16% VAT
South Africa: 15% VAT
Nigeria: 7.5% VAT
Ghana: 12.5% VAT
European Union: Local VAT rates

Account Credits

Promotional Credits

Welcome Bonus: New account credits
Referral Credits: Earn credits for referrals
Promotional Campaigns: Special offer credits
Partner Credits: Credits from partner programs

Credit Usage

Automatic Application: Credits applied automatically
Expiration Dates: Credits may have expiry dates
Usage Priority: Credits used before wallet balance
Transfer Restrictions: Credits typically non-transferable

Payment Security

Security Measures

PCI DSS Compliance: Industry-standard card security
Encryption: All payment data encrypted
Tokenization: Card details securely tokenized
Fraud Detection: Advanced fraud prevention

Data Protection

No Storage: Card details not stored on our servers
Secure Transmission: TLS encryption for all transactions
Access Controls: Strict access to payment systems
Regular Audits: Third-party security assessments

Managing Your Billing

Web Console

Access billing features through the web console:

Navigate to Account > Billing
View wallet balances and transaction history
Add payment methods and configure auto-reload
Download invoices and receipts

API Access

Programmatically manage billing:

# Get wallet balances
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lineserve.com/v1/account/wallets

# Get billing history
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lineserve.com/v1/account/billing/history

# Add funds to wallet
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50, "currency": "USD", "payment_method": "card_123"}' \
  https://api.lineserve.com/v1/account/wallets/topup

CLI Commands

# Check wallet balances
lineserve account billing

# View usage for current month
lineserve account usage

# Add funds to wallet
lineserve account topup --amount 50 --currency USD

Wallet System​

Multi-Currency Support​

Wallet Balances​

Payment Methods​

Credit/Debit Cards​

Bank Transfers​

Mobile Money​

Cryptocurrency (Coming Soon)​

Billing Cycles​

Prepaid Model​

Billing Frequency​

Auto-Reload​

Configuration​

Example Configuration​

Invoicing & Receipts​

Invoice Generation​

Invoice Details​

Usage Tracking​

Real-time Monitoring​

Cost Alerts​

Pricing Transparency​

No Hidden Fees​

Cost Optimization​

Tax & Compliance​

Tax Handling​

Supported Tax Regions​

Account Credits​

Promotional Credits​

Credit Usage​

Payment Security​

Security Measures​

Data Protection​

Managing Your Billing​

Web Console​

API Access​

CLI Commands​

Troubleshooting​

Common Issues​

Payment Failures​

Billing Discrepancies​

Getting Help​

Next Steps​