Fintech
2025
Software Engineer
Referral and Rewards System
A rewards administration system for managing referrers who bring new users to Ecobank mobile platforms.
Metrics
Referral tracking
Rewards administration
Mobile platform growth
Problem
The work started here.
Business teams needed a reliable way to manage referral activity and administer rewards for users joining Ecobank mobile platforms.
Research
- Mapped referral flows from new-user acquisition through reward administration.
- Identified the roles needed to review, manage, and approve reward actions.
- Reviewed operational edge cases around duplicate referrals, eligibility, and status changes.
Planning
- Designed referral records around referrer, referred user, status, reward state, and audit metadata.
- Planned admin screens for search, review, reward management, and operational reporting.
- Defined notification touchpoints for key referral and reward state changes.
Architecture Highlights
- React admin views connected to Spring Boot APIs for referral and rewards operations.
- RBAC restricted sensitive reward actions to approved roles.
- Notification flows surfaced operational changes to the right teams.
System Design
- Referral state transitions prevent rewards from being administered before eligibility is confirmed.
- Audit trails capture reward decisions and administrative changes.
- Search and filtering help teams manage referral records at operational scale.
Challenges
- Referral and reward states had to remain clear across business and support teams.
- Reward administration required control without slowing down legitimate approvals.
- Operational users needed fast lookup for referrer and referred-user records.
Solutions
- Modeled the workflow around explicit states and permission-aware actions.
- Added admin controls for reviewing and updating reward status.
- Built searchable views that made referral history easier to manage.
Performance
- Improved operational handling of referral records and reward actions.
- Reduced manual ambiguity by exposing status and eligibility clearly.
- Supported mobile growth operations with a repeatable administration flow.
Tech Stack
React
Java
Spring Boot
RBAC
Notifications
Code Snippet
await rewards.approve({
referralId,
reviewerId: user.id,
note: approvalNote,
});Gallery & Animations
The final product uses subtle hover tilt, reveal choreography, and responsive image transitions to make the case study feel alive without turning the page into a heavy demo reel.
Lessons Learned
- Incentive systems need transparent states because small ambiguities become support work.
- RBAC is just as important for growth tools as it is for core banking workflows.
- Operational products improve when they make edge cases visible early.