PHPackages furic/redeem-codes - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. furic/redeem-codes ActiveLibrary[Utility & Helpers](/categories/utility) furic/redeem-codes ================== The redeem code system used for creating redeem codes to compensate users, or giving rewards in events. 1.0.9(5y ago)10565MITPHPPHP ^7.2CI passing Since Nov 1Pushed 1w ago1 watchersCompare [ Source](https://github.com/furic/laravel-redeem-codes)[ Packagist](https://packagist.org/packages/furic/redeem-codes)[ Docs](https://github.com/furic/laravel-redeem-codes)[ Fund](https://paypal.me/furic)[ GitHub Sponsors](https://github.com/furic)[ RSS](/packages/furic-redeem-codes/feed)WikiDiscussions main Synced 1w ago READMEChangelog (8)Dependencies (1)Versions (12)Used By (0) Laravel Redeem Codes ==================== [](#laravel-redeem-codes) > **Retired.** This package is no longer maintained. The successor is [`furic/filament-redeem-codes`](https://github.com/furic/filament-redeem-codes) โ€” a ground-up rewrite as a Filament v5 plugin with multi-reward campaigns, admin-managed reward types, a typed API, and a real test suite. New projects should use that instead. --- [![Packagist](https://camo.githubusercontent.com/f3d0782b49273ea202e55ee43887a752251bab1264bd2ac60d28df7afcb797a0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66757269632f72656465656d2d636f646573)](https://packagist.org/packages/furic/redeem-codes)[![Packagist](https://camo.githubusercontent.com/d4ae5bafe54dafd92beb4962bb6f73160d7ff4ac8744511b338b2adf41c804c3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66757269632f72656465656d2d636f646573)](https://packagist.org/packages/furic/redeem-codes)[![License](https://camo.githubusercontent.com/e3f684b4642988cc9a42fafdf6dd4d00bacefd7fe4dd07747786043868b447ff/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f66757269632f6c61726176656c2d72656465656d2d636f646573)](https://packagist.org/packages/furic/redeem-codes) > A plug-and-play redeem code management system for [Laravel](https://laravel.com/) applications. `laravel-redeem-codes` is a lightweight package for managing and redeeming codes in Laravel projects. Originally developed for player compensation and event reward systems at [Sweaty Chair Studio](https://www.sweatychair.com), this package offers both a clean API and a simple web-based console for managing redeem codes. If you're looking for more flexible implementations, also consider: - [Laravel Promocodes](https://github.com/zgabievi/laravel-promocodes) - [Laravel Vouchers](https://github.com/beyondcode/laravel-vouchers) --- Table of Contents ----------------- [](#table-of-contents) - [Installation](#installation) - [Configuration](#configuration) - [Usage](#usage) - [Web Console](#web-console) - [Redeem Code Parameters](#redeem-code-parameters) - [Redeem Validator API](#redeem-validator-api) - [Unity Client Integration](#unity-client-integration) - [TODO](#todo) - [License](#license) --- Installation ------------ [](#installation) Install the package via Composer: ``` composer require furic/redeem-codes ``` > Laravel 5.5+ will auto-discover the service provider. For earlier versions, register it manually. ### Manual Setup (for Laravel < 5.5) [](#manual-setup-for-laravel--55) Add the service provider to your `config/app.php`: ``` 'providers' => [ // ... Furic\RedeemCodes\RedeemCodesServiceProvider::class, ], ``` --- Configuration ------------- [](#configuration) Publish the package's configuration and migration files: ``` php artisan vendor:publish ``` Then run the migration to create the redeem codes table: ``` php artisan migrate ``` --- Usage ----- [](#usage) ### Web Console [](#web-console) Visit your application at `/redeem-codes` to access the web-based admin console. [![Laravel Redeem Codes web console](https://camo.githubusercontent.com/ea9250e50d567249d29b9d167015be28b143c2f5ce9604ee96bf58d13652e964/68747470733a2f2f7777772e7269636861726466752e6e65742f77702d636f6e74656e742f75706c6f6164732f6c61726176656c2d72656465656d2d636f6465732d636f6e736f6c652e6a7067)](https://camo.githubusercontent.com/ea9250e50d567249d29b9d167015be28b143c2f5ce9604ee96bf58d13652e964/68747470733a2f2f7777772e7269636861726466752e6e65742f77702d636f6e74656e742f75706c6f6164732f6c61726176656c2d72656465656d2d636f6465732d636f6e736f6c652e6a7067) Use this interface to browse, create, and manage redeem codes visually. --- ### Redeem Code Parameters [](#redeem-code-parameters) When creating a redeem code, the following fields are available: - **Code Prefix**: Optional prefix for the redeem code(s), useful for organizing events (e.g., `EASTER23_`). All codes are 12 characters in total. - **Reusable**: If enabled, the same code can be used by multiple users. Note: the package does not enforce per-user usage restrictionsโ€”you must handle this on the client side. - **Count**: Number of codes to generate. - **Description**: Internal notes about the purpose of the code batch. - **Rewards**: Define one or more reward types with a quantity. Rewards are stored as numeric types and should be interpreted using an Enum or similar mapping on the client side. > To modify reward types or customize the form, edit the `index.blade.php` file. --- ### Redeem Validator API [](#redeem-validator-api) The API endpoint: ``` GET /api/redeem/{code} ``` This will return the reward data in JSON format for valid codes (HTTP `200`) or an error response (HTTP `400`) if invalid, already used, or expired. Explore the API in the [Postman documentation](https://documenter.getpostman.com/view/2560814/TVmV6tm8#ea7b5c97-7ed2-40b9-91d0-a658a6088097). --- ### Unity Client Integration [](#unity-client-integration) If you're using Unity, you can connect easily using this open source client: ๐Ÿ‘‰ [Unity-Redeem-Codes Repo](https://github.com/furic/Unity-Redeem-Codes) --- TODO ---- [](#todo) - โœ… Add configurable reward item types via config file. - ๐Ÿ”’ Add authentication for web console (currently open). - ๐Ÿงช Add tests and model factories. - ๐Ÿ“œ Add history log page (already logged in DB). - โš  Add server-side check for reusable codes (low priority). --- License ------- [](#license) This package is open-sourced software licensed under the [MIT license](https://github.com/furic/laravel-redeem-codes/blob/main/LICENSE). ### Health Score 39 โ€” LowBetter than 86% of packages Maintenance64 Regular maintenance activity Popularity17 Limited adoption so far Community10 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~5 days Total 11 Last Release 1971d ago Major Versions 0.1.0 โ†’ 1.0.02020-11-08 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/44884321?v=4)[Richard Fu](/maintainers/furic)[@furic](https://github.com/furic) --- Top Contributors [![furic](https://avatars.githubusercontent.com/u/44884321?v=4)](https://github.com/furic "furic (45 commits)") --- Tags laravellaravel-5-packagelaravel-packagephppromo-codepromocoderedeem-codevoucherphpeventlaravelrewardpromo codecoupon codediscount coderedeem code ### Embed Badge ![Health badge](/badges/furic-redeem-codes/health.svg) ``` [![Health](https://phpackages.com/badges/furic-redeem-codes/health.svg)](https://phpackages.com/packages/furic-redeem-codes) ``` ### Alternatives [gehrisandro/tailwind-merge-laravel TailwindMerge for Laravel merges multiple Tailwind CSS classes by automatically resolving conflicts between them 341682.2k18](/packages/gehrisandro-tailwind-merge-laravel)[trexology/promocodes Promotional Codes Generator for Laravel 5.1 121.2k](/packages/trexology-promocodes)[iteks/laravel-enum A comprehensive Laravel package providing enhanced enum functionalities, including attribute handling, select array conversions, and fluent facade interactions for robust enum management in Laravel applications. 2516.7k](/packages/iteks-laravel-enum)[salmanzafar/laravel-geocode A Laravel Library to find Lat and Long of a given Specific Address 153.9k](/packages/salmanzafar-laravel-geocode) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)