PayNow ecosystem

Government institutions connect directly to PayNow to manage public payments.

This repository is the external government institution portal, not the internal PayNow staff portal. It serves Ethiopian government bodies that need to create bills, view payments, track revenue, export reports, manage institution users, and reconcile collections through PayNow.

Ethiopian Revenue AuthorityWater utilitiesMunicipalitiesLand administration officesSchools and universitiesTransport authorities
Connected architecture
Portal -> PayNow API -> Core platform

The government portal sits on top of PayNow API and connects into Transaction service, Ledger, Settlement, Risk engine. Core events include government.bill.created, government.payment.received, government.revenue.settled. Primary endpoints include /v1/government/bills, /v1/government/payments, and /v1/government/reconciliation.

Institution structure
Ethiopia
Tigray
Mekelle
Mekelle Woreda 03
Mekelle Water Authority
What belongs here

External government institution workflows

Create billsView paymentsTrack revenueExport reportsManage institution usersReconcile payments
Dashboard
Billing
Payment monitoring
Reconciliation
Institution management
Analytics
User management
Handled elsewhere

Adjacent repos with different responsibilities

paynow-admin-portal
PayNow staff

Internal operations, merchant approvals, government onboarding, settlement control, platform monitoring, and system configuration.

paynow-risk-portal
Risk and fraud team

Fraud monitoring, AI alerts, transaction investigation, chargeback review, merchant risk scoring, and rules management.

paynow-merchant-portal
Merchants and businesses

Merchant dashboards, transaction history, refunds, settlement reports, QR payments, and invoice workflows.

paynow-mobile-app
Citizens and customers

Utility payments, school payments, tax payments, merchant QR payments, wallet functions, and customer transaction history.

paynow-developer-portal
API developers

API documentation, API keys, sandbox testing, webhook configuration, SDK downloads, and usage analytics.

Supported services
Water utilities
ETB 8.4M
14,202 payments
Top region: Addis Ababa
School fees
ETB 6.1M
9,514 payments
Top region: Oromia
Tax payments
ETB 19.8M
11,223 payments
Top region: Addis Ababa
Land administration
ETB 4.7M
3,104 payments
Top region: Amhara
Security baseline
Role-based access by institution and service type
Two-factor authentication for institution users
IP allow lists for finance and reconciliation teams
Immutable audit logs for user, action, timestamp, and IP
Shared UI components belong in paynow-design-system. Internal onboarding, settlement control, and system operations stay in paynow-admin-portal rather than this repository. Public citizen collection pages can live here as routed service journeys while still posting into the same PayNow core.
Final repository architecture
Clean separation across the PayNow ecosystem

The ecosystem is finalized so each repository has a single audience and clear responsibility. This portal remains the government institution surface only.

PayNowpaynow-infrastructurepaynow-admin-portalpaynow-risk-portalpaynow-merchant-portalpaynow-government-portalpaynow-mobile-apppaynow-developer-portalpaynow-design-systempaynow-docsPayNowFrontpage
RepositoryWho uses itPrimary responsibility
PayNowBackend servicesCore financial engine for payments, transactions, ledger, settlement, payouts, government services, merchants, customers, risk hooks, and event streaming.
paynow-infrastructureDevOpsTerraform, Kubernetes deployment, Kafka and events, CI/CD, observability, monitoring, security, and scripts.
paynow-admin-portalPayNow staffInternal operations portal for monitoring, onboarding, settlement control, approvals, system configuration, logs, and support workflows.
paynow-risk-portalRisk teamFraud dashboard, investigations, alerts, analytics, chargeback review, and risk scoring operations.
paynow-merchant-portalMerchantsMerchant-facing dashboard for payments, refunds, settlements, QR payments, invoice generation, and business reporting.
paynow-government-portalGovernment institutionsExternal institution portal for billing, payments, revenue tracking, reports, user management, and payment reconciliation.
paynow-mobile-appCitizensCustomer wallet and payment app for utilities, school fees, tax payments, merchant QR payments, and transaction history.
paynow-developer-portalDevelopersDeveloper onboarding for docs, keys, sandbox access, webhooks, SDKs, and integration analytics.
paynow-design-systemAll portals and appsShared UI components, patterns, icons, charts, tables, forms, and navigation primitives.
paynow-docsDocumentation consumersArchitecture, API reference, integration guides, security documentation, SDK guides, and government payment model docs.
PayNowFrontpageMarketing and public visitorsPublic website for product positioning, merchant onboarding, developer acquisition, and government partnership messaging.