otp-smsplog

byAbdullahi Olarewaju

Build a virtual number /OTP saas called SMSPLOG- Nigeria’s #1 virtual number store for verifications. CORE IDEA: Users buy temporary and rent virtual numbers to receive OTP for apps. We resell numbers from API providers. COMPLIANCE FIRST: -Users must be 16+ and verify phone number before buying -Show warning on signup: “numbers must not be used for fraud, spam or impersonation. ALL orders are logged. Account will be banned for illegal use.” -Add terms page. USER ROLES: -User: buy numbers, fund wallet -Admin: manage pricing, orders, users SCREEN 1-Auth: -signup with phone + email +password -login SCREEN 2 – Home /buy number (main screen): -Top: wallet balance with deposit button ( paystack mock –add funds ) -Filter row: service icons to filter: Whatsapp, Telegram, Facebook, Signal, Instagram, Google/Gmail, Tiktok, Twitter/X, Discord, Uber\Bolt, Amazon . - Country Selector: Dropdown – USA, UK, NIGERIA, CANADA, POLAND, NETHERLANDS, INDONESIA, (most popular for OTP) -number list: show available numbers with price in naira, e. g “USA whatsapp- ₦850”, “UK telegram -₦600”, USA facebook - ₦1200”. Button “buy” -After buy: deduct from wallet, show screen with: Phone number, service name, status “waiting for SMS”, Timer 15 minutes, Area to show OTP”, “cancel number (refund 70% if no SMS)”, “ BUY another” SCREEN 3 – My Orders: -Tabs: Active, comp0leted, cancelled -show number, service, country, OTP received, time, price SCREEN 4 – wallet: -Balance, deposit via paystack, withdraw, transaction history -All purchases deduct from wallet. No negative balance. SCREEN 5 – Pricing logic (backend): -create table for providers: 5sim.net / SMS-activate API mock -Admin can set: Base Cost + profit Margin. Example: Base $0.50, sell for ₦1000. System auto calculates profit. -when user buys, backend should call mock external API: POST https://api.provider.com/getnumber (service, country) returns number. Then poll for SMS. SCREEN 6 – Admin panel / admin (Admin only): - Dashboard: Total users, total orders today, profit today - User Management: List users, ban user - Number Management: Add/Edit services (WhatsApp, Signal, Telegram, Facebook, etc), Set price per service per country - Orders Management: View all orders, manually input OTP if needed, refund - Provider Settings: Set API key for 5SIM, set markup % - Transaction Logs: All wallet activity DESIGN: - Clean white, orange and dark blue like Paystack dashboard. Mobile first, big buttons, copy number with one tap. - Show WhatsApp, Telegram, Facebook, Signal logos as filter chips. TECH: - React + Tailwind frontend - FastAPI + Postgres backend - Tables: users, kyc, wallet_transactions, orders, services, countries, pricing - Mock the SMS provider API but structure code so real API key can be added later in env file. - Seed data: 20 numbers for WhatsApp, Telegram, Facebook, Signal. Generate full working code with seed data and test wallet deduction.