PPPoE customers

Each PPPoE customer has a login (username and password), a package, an optional router device, an expiry date (Paid Until) and a wallet with its own account number that they pay into. You add and manage customers from Services → PPPoEs (/dashboard/pppoes).

Add a customer

Go to Services → PPPoEs and click Add PPPoE Customer.

Fill in the form:

Field	Notes
Name	Required.
Account Number	Optional, your own reference such as `ACC-12345`.
Username	Optional. Leave blank and the customer’s ISPMan account number becomes their username.
Password	Optional. Leave blank and a password is generated.
E-Mail	Optional. Needed to email invoices.
Enter Phone Number	Used for SMS and payment prompts. Pick the country code from the dropdown.
PPPoE Package	Required.
PPPoE Server Device	The router this customer dials into.
Installation Fee (one-time, optional)	Charged once with the first package payment.
PPPoE Customer Location	Free text.
Branch	Shown only when branches are turned on.

Click Save. You’ll see “Customer created successfully” and land on the customer’s page.

When the customer is created, ISPMan sets up their login, opens a wallet with its own account number, gives them a static IP if a PPPoE network is configured (see Router setup), and sends a welcome SMS if you have bound a PPPoE welcome template.

Import and export

Import opens Import PPPoE Customers: upload a CSV or Excel file, or paste CSV text. See Importing customers for the columns and how existing customers are handled.
Export downloads the customer list as CSV. Pick the columns you want. The file follows the status tabs you have selected.
Dispatch PINs generates a 4-digit PIN for customers and sends it by SMS, for customers created Today, This Week or From Beginning. Customers who already have a PIN are skipped unless you tick Regenerate PINs for customers who already have one. SMS charges apply for each message.

The customer page

Click any customer to open their page (/dashboard/customers/pppoe/<id>). At the top is the Actions grid, with links to Access Logs and How to Connect. Below it you’ll find the live session, the last login attempt, account details and balances, Package Details, Device Details, Session History and Recent Customer Payments.

Actions

Button	What it does
STK Push	Sends a payment request to the customer’s phone for the amount due (including any unpaid installation fee). Choose a payment method; some methods ask for an OTP.
Connect	Connects the customer until a date and time you choose. See Connecting manually.
Deactivate / Activate	Deactivating stops the customer connecting until you reactivate them. Activating lets them connect again.
Send SMS	Sends a message, optionally from a template. Disabled if the customer has no phone number.
Password	Changes the PPPoE password. They stay connected until they next reconnect.
Disconnect	Drops the live session and expires the account, so they can’t reconnect until they pay. Any paid time left is discarded.
Reset Conn.	Ends all the customer’s sessions on every router so they log in fresh. Their account is not changed.
E-Mail	Sends an email.
Package	Moves the customer to another package. They stay on the old speed until they reconnect.
To Static	Converts the customer to a static (fixed-IP) customer. See below.
Delete	Archives the account. You can restore it later from Settings → Recently Deleted.
Max Conn.	Sets how many connections the customer may have at once, and whether to split the bandwidth between them.
Username	Changes the PPPoE username.
MAC Binding	Controls which router the customer may connect from: Disabled, Match by prefix or Bind to specific MACs. The first router they connect from is learned automatically.
Deduct Bal.	Takes money off the customer’s balance. Shown only when there is a balance.
PIN / Set PIN	Sets a new 4-digit PIN, or generates one and sends it by SMS.
Static IP	Assigns, reassigns or removes the customer’s static IP. Shows the IP once assigned.
Flight Speed	Changes the speed for the current session only. It reverts when they reconnect.
Speed Override	Sets a permanent speed for this customer in place of the package speed.

Next to the account details you’ll also find See Credentials, Edit Details (name, email, M-PESA number, account number, location, Special Price, package, device and branch), and Deposit.

Connecting manually

Connect lets you turn a customer on without them paying through the system. Choose a Connection Mode:

Normal: standard connection until the Package Expiry Date you choose. You can record a Payment Method of Cash or Cheque (with an optional cheque image), or No payment record.
Grace Period: connects now, the customer pays later. Pick when the grace period ends.
Free Trial: no payment required, until the date you pick.

Deposit

Deposit records money a customer paid you outside the payment flow: Cash, Cheque or Electronic (paid straight to one of your payment providers). Enter the Amount, an optional Transaction ref and Note. The deposit is credited to the customer and used to pay for their service.

Convert to static

To Static creates a fixed-IP customer, moves the customer’s wallet to it, and archives the PPPoE account. Choose a Router Device with a static network and optionally a fixed IP (blank picks the next free one). If the customer was converted from static before, their original static record is restored instead. See Statics.

If the customer’s last login failed, the page shows “This PPPoE account failed to authenticate” next to the live session, with recent attempts. A session that is up while another device keeps failing usually means two routers are using the same login. See Sessions and logs.