feat: add ability to replace UnacceptedTransactionException with 'false' on insufficient wallet

Author: muath-ye

README.md

@@ -103,6 +103,8 @@ $user->wallet->forceWithdraw(500);
 $user->wallet->balance; // -24.8990
 ```
 
+> If you don't want [UnacceptedTransactionException] you can change the `wallet.disable_insufficient_exception` config value to disable the exception or set `WALLET_DISABLE_INSUFFICIENT_EXCEPTION` to `true` on your `.env`
+
 ## Advanced Usage
 
 You can easily add meta information to the transactions to suit your needs. For example:

config/config.php

@@ -46,4 +46,18 @@
     |
     */
     'auto_recalculate_balance' => env('WALLET_AUTO_RECALCULATE_BALANCE', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Throwing Exception for Insufficient Balance
+    |--------------------------------------------------------------------------
+    |
+    | This value is to disable exception handling when the request withdraw
+    | amount is greater than current user balance on his wallet, if you
+    | disabled the exception handling, the withdraw process will not proceeded
+    | and the return will be false the balance will stay as is. default value
+    | is false.
+    |
+    */
+    'disable_insufficient_exception' => env('WALLET_DISABLE_INSUFFICIENT_EXCEPTION', false),
 ];

src/Models/Wallet.php

@@ -132,7 +132,11 @@ public function withdraw($amount, $meta = [], $type = 'withdraw', $shouldAccept
             ]);
 
         if (!$accepted) {
-            throw new UnacceptedTransactionException($transaction, 'Withdrawal not accepted due to insufficient funds!');
+            return config('wallet.disable_insufficient_exception')
+                ? false
+                : throw new UnacceptedTransactionException(
+                    $transaction, 'Withdrawal not accepted due to insufficient funds!'
+                );
         }
         $this->refresh();
         return $transaction;