How comethrusws/nexara-backend works
Nexara is a NestJS payment-orchestration API for merchants and operations staff. The merchant workflow covers OTP-based access and onboarding, KYC, wallet funding and activity, beneficiary management, and payouts; payouts route through organization-configured bank adapters while Fineract is the live ledger. Operations configure organizations, features, banks, and fees, and manage merchant KYC and wallets. The README documents additional bill payments, reconciliation, dashboard, audit, notifications, and webhooks. Several service implementations were not sampled, so uncertain internal wiring is omitted.
Main entry points: portal.controller.ts Merchant portal API · merchants.service.ts Merchant management · payouts.service.ts Payout orchestration · fee-engine.service.ts Fees and commissions
Components 23
Identity and onboarding
- Authentication
src/modules/auth/auth.service.ts - Onboarding portal
src/modules/portal/onboarding.controller.ts
Merchant payments
- Merchant portal API
src/modules/portal/portal.controller.ts - Wallet and activity
src/modules/wallet/wallet.service.ts - Payout orchestration
src/modules/payouts/payouts.service.ts - Beneficiaries
src/modules/beneficiaries/beneficiaries.service.ts - Bill payments
src/modules/bbps/bbps.service.ts - Merchant webhooks
src/modules/webhooks/webhooks.service.ts
Operations and governance
- Merchant management
src/modules/merchants/merchants.service.ts - Organization and bank config
src/modules/organizations/organizations.service.ts - Fees and commissions
src/modules/fee-engine/fee-engine.service.ts - Reconciliation
src/modules/reconciliation/reconciliation.service.ts - Operations dashboard
src/modules/dashboard/dashboard.service.ts - Audit log
src/modules/audit/audit.service.ts - Notifications
src/modules/notifications/notifications.service.ts
Provider integrations
- Fineract ledger
src/integrations/fineract/fineract.adapter.ts - Bank adapter registry
src/integrations/banks/bank.registry.ts - KYC provider
src/integrations/kyc/kyc.module.ts - Document storage
src/integrations/storage/storage.module.ts
Platform state
- PostgreSQL
Other components
- Merchant
- Operations staff
- Payout bank
Connections 28
- Merchant → Authentication: requests access
- Authentication → PostgreSQL: reads and writes
- Merchant → Onboarding portal: submits onboarding
- Onboarding portal → Authentication: checks OTP
- Operations staff → Merchant management: manages merchants
- Merchant management → KYC provider: verifies identity
- Merchant management → Document storage: stores documents
- Merchant → Merchant portal API: uses API
- Merchant portal API → Wallet and activity: handles wallet requests
- Merchant portal API → Payout orchestration: handles payouts
- Merchant portal API → Beneficiaries: manages payees
- Merchant portal API → Bill payments: requests bill payments
- Merchant portal API → Merchant webhooks: manages webhooks
- Payout orchestration → Bank adapter registry: selects bank adapter
- Bank adapter registry → Payout bank: dispatches payout
- Wallet and activity → Fineract ledger: posts ledger activity
- Operations staff → Organization and bank config: configures hierarchy
- Organization and bank config → PostgreSQL: stores routing and features
- Operations staff → Fees and commissions: updates fee config
- Fees and commissions → Audit log: records changes
- Fees and commissions → PostgreSQL: reads and writes
- Operations staff → Reconciliation: runs reconciliation
- Operations staff → Operations dashboard: views operations
- Operations staff → Notifications: manages notifications
- Merchant management → PostgreSQL: stores merchant records
- Payout orchestration → PostgreSQL: stores payout state
- Beneficiaries → PostgreSQL: stores payees
- Merchant webhooks → PostgreSQL: stores endpoints and deliveries