Port 80 Unified Reverse Proxy

EthioPay Microservices API Gateway

Central entry point routing all client traffic to 10 underlying backend services

Account Service :8000

Auth, KYC, RSA-2048 JWT, Merchant Onboarding & Sub-users

  • → /api/auth/merchant/v1/*
  • → /api/auth/admin/v1/*
  • → /api/auth/shared/v1/*
  • → /api/internal/*
Checkout Service :8005

Payment Session Creation, Initiation & API Key Gateway

  • → /api/v1/payment/*
  • → /api/v1/transaction/*
  • → /api/v1/transactions/*
  • → /api/v1/validate-api-key
Transaction Service :8085

Dual-Ledger Auditing, Search, Filtering & Merchant Analytics

  • → /api/v1/admin/transactions*
  • → /api/v1/merchant/transactions*
  • → /api/v1/merchant/:id/transactions*
Settlement Service :8086

Bank Accounts, Daily Balances & Merchant Payout Schedulers

  • → /api/v1/admin/settlements*
  • → /api/v1/merchants/:id/balances*
  • → /api/v1/merchants/:id/settlement-accounts
Management Service :8002

Admin & Merchant RBAC, Ticketing Workflows & Escalation

  • → /api/managment/merchant/v1/*
  • → /api/managment/admin/v1/*
  • → /api/v1/management/apikey/validate
Notification Service :8001

Real-time SSE, Broadcasts, Email (SMTP), FCM Push & SMS

  • → /api/v1/notifications/sse
  • → /api/v1/notifications/merchant/*
  • → /api/v1/notifications/broadcast/*
Clearing Service :8080

Batch CSV Uploads, Streaming Parser & WebSocket Progress

  • → /api/v1/clearing/upload
  • → /api/v1/clearing/transactions
  • → /api/v1/clearing/ws-upload (WS)
Reconciliation Service :8080

Discrepancy Audits, Defective Transactions & Manual Settle

  • → /api/reconciliation/admin/v1/*
  • → /api/reconciliation/health
Payment Connectors M-Pesa / Telebirr

Telecom Adapter Gateways & Webhook Receivers

  • → /callback (M-Pesa STK Callback)
  • → /mpesa/*
  • → /telebirr/*
Gateway is live on port 80. Check gateway overall status at /health.