feat: add ability to replace UnacceptedTransactionException with 'fal…

…se' on insufficient wallet

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;