DOCS

Payments & Billing

Configure payment gateways and manage transactions with mobile money integration.

Supported Payment Methods

PesaPal
Mobile Money (MTN MoMo, Airtel Money), Card payments, Bank transfers
Vouchers
Pre-generated voucher codes for offline sales and distribution

PesaPal Configuration

  1. Create a PesaPal merchant account at pesapal.com
  2. Get your API credentials from the PesaPal dashboard
  3. Go to Settings → Payments
  4. Enter your credentials:
Consumer Key
Your PesaPal Consumer Key from the merchant dashboard
Consumer Secret
Your PesaPal Consumer Secret (keep this private)
IPN ID
Instant Payment Notification ID for callbacks
Sandbox Mode
Enable for testing (disable for production)
Important
Register your IPN callback URL in the PesaPal dashboard before going live. Without this, payment confirmations won't be received.

Payment Flow

Customer → Captive Portal → Select Package → Enter Phone
    ↓
Mobile Money Prompt → Customer Enters PIN
    ↓
PesaPal → Payment Confirmed → IPN Callback
    ↓
System → Create/Extend Customer Account
    ↓
SMS → Send Login Credentials
    ↓
Customer → Connected to Internet

Viewing Payments

Go to Finance → Payments to see all transactions:

  • Filter by date range
  • Filter by payment status
  • Filter by payment method
  • Search by customer or transaction ID

Payment Status

Pending
Waiting for payment confirmation from gateway
Completed
Payment successful, account activated
Failed
Payment was not successful
Cancelled
Payment was cancelled by user

Manual Payments

For cash or other offline payments:

  1. Go to Finance → Payments
  2. Click Record Payment
  3. Select the customer and package
  4. Enter payment details
  5. The account is activated immediately

Voucher System

Generating Vouchers

  1. Go to Finance → Vouchers
  2. Click Generate Vouchers
  3. Select package and quantity
  4. Vouchers are created with unique codes

Printing Vouchers

  • Select vouchers to print
  • Choose print layout (cards, list)
  • Print for distribution to resellers

Activating Vouchers

Customers can activate vouchers on the captive portal:

  1. Connect to WiFi
  2. Enter voucher code on captive portal
  3. Account is activated immediately

Reports

Available financial reports:

  • Daily/Weekly/Monthly revenue
  • Payment method breakdown
  • Package sales analysis
  • Customer acquisition trends

Troubleshooting

Payment Not Confirmed

Common Issues
  1. Check if IPN callback URL is correctly registered
  2. Verify PesaPal credentials are correct
  3. Check server logs for callback errors
  4. Contact PesaPal support if issues persist

Account Not Activated After Payment

  1. Check if payment status is "Completed"
  2. Verify the customer record was created
  3. Check RADIUS for authentication issues
  4. Manually activate if needed