Laravel Referral Bonus Integration

I have an existing Laravel-based platform that already handles user registration and deposits. What I’m missing is a referral bonus system that credits the referrer with a fixed amount as soon as the person they invited makes their very first deposit.

Here’s what I need built and seamlessly merged into my current codebase:

• A referral engine that links the new user to the referrer through a unique referral code that already exists in the registration flow.
• Logic that checks “initial deposit only” for the referred account and, on success, credits a fixed bonus to the referrer’s balance.
• An admin-side setting where I can adjust that fixed bonus amount without touching code.
• A database migration (if required) to store referral transactions for future reporting.
• Clear comments in the code plus a brief implementation note so the next developer can follow the flow.

Everything must follow Laravel best practices—policies, events/listeners, queued jobs if necessary—and fit cleanly with my current authentication and wallet modules. I’ll provide a staging branch on Git and a sample dataset so you can test the full deposit cycle.

If you’ve rolled out similar reward systems in Laravel before, I’d love to see a quick example or snippet. Once the feature passes my own test cases and is merged into the repo, the project’s complete.