yasser-elgammal/laravel-easy-wallet

A package to make easy wallet for laravel projects.

1.0.3 2025-08-09 15:02 UTC

Requires (Dev)

• orchestra/testbench: ^10.4
• phpunit/phpunit: ^11.5

MIT

• YasserElgammal

README

Laravel Easy Wallet is a simple and extensible wallet system for Laravel applications. It allows you to associate wallets with any model, manage balances, and record transactions with support for credit and debit operations using enums.

🚀 Features

• Attach a wallet to any Eloquent model (walletable)
• Automatically create a wallet if it doesn’t exist
• Credit and debit balance safely inside a DB transaction
• Transaction history tracking

📦 Installation

composer require yasser-elgammal/laravel-easy-wallet

💸 Usage Example

1. Add HasWallet Trait into models that need to has wallets

This enable wallet functionality, this will create wallet relation between current model and wallet

use YasserElgammal\LaravelEasyWallet\Traits\HasWallet;

class User extends Model
{
    use HasWallet;

    /**
     * Automatically create a wallet when the model is created.
     * Set to false if you want to disable auto creation.
     * Default is [true] when not included $autoCreateWallet property
     */
    protected bool $autoCreateWallet = false;
}

2. Credit Wallet

use YasserElgammal\LaravelEasyWallet\Facades\EasyWallet;
use App\Models\User;

$user = User::find(1);

EasyWallet::credit($user, 100.00, 'Initial deposit');

3. Debit Wallet

EasyWallet::debit($user, 25.00, 'Purchased course');

4. Transfer Between Wallets

$fromUser = User::find(1);
$toUser = User::find(2);

EasyWallet::transfer($fromUser, $toUser, 40.00, 'Transfer to friend');

5. Get Wallet Balance

$balance = EasyWallet::balance($user);

⛏ Customization

Change prefix for wallet transaction number

by default it's "TXN-" You can customize it by adding this attribute in .env file

WALLET_TXN_PREFIX=

🔧 Extra : Publishing Resources

You can optionally publish the following resources if you want to customize them:

🛠️ 1. Publish the Configuration File

php artisan vendor:publish --tag=easy-wallet-config

This will copy the config file to:

config/easy-wallet.php

🗃️ 2. Publish the Migrations

php artisan vendor:publish --tag=easy-wallet-migrations

This will copy the migration files to:

database/migrations/

You can then modify them if needed before running:

php artisan migrate

🧩 3. Publish the Models

php artisan vendor:publish --tag=easy-wallet-models

This will copy the Eloquent models to your application:

app/Models/Wallet.php
app/Models/WalletTransaction.php

You can publish these if you want to override or extend the default behavior.

🤝 Contributing

Contributions are welcome and appreciated!

If you have an idea, feature request, bug fix, or any improvement:

• Feel free to open an issue.
• Submit a Pull Request.
• Or simply get in touch if you need help.

Thank you for supporting the project! 🙌