Loading...
Home Admin Guide Reseller Guide User Guide API Admin Portal

Admin Guide

Complete guide for Super Admin to configure, manage resellers, and handle billing for the SMS Gateway Platform.

Initial Setup

When you first access the Admin Portal, you'll need to create your Super Admin account.

Access Admin Portal

Navigate to https://selfhost.smpp.asia/admin.html

Create Super Admin Account

Fill in your name, email, and password (minimum 8 characters). This will be your master admin account.

Login to Dashboard

After setup, you'll be automatically logged in to the admin dashboard.

Important: Keep your admin credentials secure. There's no password recovery for the super admin account.

Dashboard Overview

The dashboard provides a quick overview of your platform's status.

Stats Cards

MetricDescription
ResellersTotal number of registered resellers
ClientsTotal number of end-user clients
Gateways OnlineNumber of active Android gateway devices
SMS TodayTotal SMS sent today across all clients

System Info

Shows current domain configuration and API port information.

SMPP Server Status

Displays SMPP server host, port, active users, and running status.

System Settings

Configure your platform's core settings from the Settings section.

SettingDescriptionDefault
domainPlatform domain nameselfhost.smpp.asia
platform_namePlatform display nameSelfhost SMS
smtp_hostSMTP server for emails-
smtp_portSMTP port587
smtp_userSMTP username-
smtp_passSMTP password-
Changes to settings take effect immediately. No server restart required.

Reseller Management

Creating a Reseller

Click "Add Reseller" Button

Opens the reseller creation modal.

Fill Reseller Details

Company name, subdomain (lowercase), email, phone, password, and commission rate.

Save Reseller

The reseller account is created with 0 credit balance.

Adding Credit to Reseller

Click "Credit" Button

Next to the reseller in the list.

Enter Amount

Enter the credit amount in MMK (e.g., 500000).

Add Description

Optional description like "Monthly top-up" or "Initial credit".

Confirm

Credit is added to reseller's balance immediately.

Resellers can use their credit balance to activate client packages.

Client Management

View and manage all clients across all resellers.

Client List

Shows all clients with their reseller, package, credit, daily sent count, and status.

Client Actions

ActionDescription
ActivateActivate a client's package (deducts from reseller credit)
SuspendTemporarily disable client's access
CreditAdd credit directly to client (for direct clients)

Billing & Revenue

Package Pricing

PackagePrice (MMK/month)Daily LimitMonthly LimitDevices
Starter Pro50,000451,3501
Business Elite100,0001805,4002
Enterprise Pro200,00036010,8003
Enterprise Max400,00055016,5004

Billing Flow

1. Admin adds credit to Reseller β†’ Reseller balance increases
2. Reseller creates Client β†’ Client gets 3-day trial
3. Trial expires β†’ Client needs package activation
4. Reseller activates package β†’ Reseller credit deducted
5. Client active for 30 days β†’ Renewal needed after expiry

Transaction History

View all billing transactions with filters:

  • topup - Credit added to reseller
  • package_purchase - Package activation/renewal

SMPP Server

SMPP Server Details

SettingValue
Hostselfhost.smpp.asia
Port2558
Rate Limit10 TPS per user
PM2 Processselfservice-smpp
Each client gets unique SMPP credentials (system_id and password) auto-generated on registration.

Troubleshooting

Common Issues

IssueSolution
Can't login to adminCheck email/password. Clear browser cache.
SMPP server offlineSSH to server and run: pm2 restart selfservice-smpp
API not respondingSSH to server and run: pm2 restart selfservice-api
Client can't send SMSCheck: trial expired? package expired? daily limit reached?

Server Commands

# View API logs
pm2 logs selfservice-api --lines 50

# View SMPP logs
pm2 logs selfservice-smpp --lines 50

# Restart services
pm2 restart selfservice-api
pm2 restart selfservice-smpp