Events & commands
Events
Section titled “Events”All implement ShouldDispatchAfterCommit: they fire only after the surrounding database transaction commits, so listeners
never see rolled-back payments. Namespace Hsemix\AdvancedWallet\Events.
| Event | Properties | Fired when |
|---|---|---|
PaymentPerformed |
transaction |
A payment is booked (immediately, or on authorize) |
PaymentPending |
transaction |
A payment is held for authorization |
PaymentDenied |
transaction, reason |
deny() |
PaymentRequested / PaymentRequestAccepted / PaymentRequestRejected / PaymentRequestCancelled / PaymentRequestExpired |
request (a MoneyRequest) |
Wallet::requests() create / accept / reject / cancel / expireDue() |
PaymentCancelled |
transaction |
cancel() on a pending payment, or cancelling a scheduled payment |
PaymentChargedBack |
original, chargeback |
chargeback() |
InstallmentProcessed |
installment |
An installment was paid (including the immediate first one) |
InstallmentFailed |
installment |
An installment failed for lack of funds |
AccountFeeCharged / AccountFeeSkipped |
charge (an AccountFeeCharge) |
An account fee was collected / forgiven for lack of funds |
PaymentPerformed is not fired for installments (use InstallmentProcessed) or for chargebacks (PaymentChargedBack).
Example: notifications
Section titled “Example: notifications”Event::listen(PaymentPerformed::class, function (PaymentPerformed $e) { $type = $e->transaction->transferType;
if ($type->notify_payment_received) { $e->transaction->toAccount->owner?->notify(new PaymentReceived($e->transaction)); } if ($type->notify_payment_sender) { $e->transaction->fromAccount->owner?->notify(new PaymentSent($e->transaction)); }});(owner is null for system accounts.)
Commands
Section titled “Commands”Registered when config('wallet.commands') is true (default).
wallet:process-scheduled
Section titled “wallet:process-scheduled”php artisan wallet:process-scheduled [--date=YYYY-MM-DD]Runs Wallet::scheduled()->processDue() and prints Processed N installment(s), M failed, K deferred. Then collects due account fees (Account fees: N charged, M skipped, K waived, P pending.) and expires overdue payment requests (Expired N payment request(s)., always based on the current time, not --date). Always exits 0.
wallet:reconcile
Section titled “wallet:reconcile”php artisan wallet:reconcile [--account=ID] [--fix]Compares each account’s cached balance with the ledger, and its cached reserved total with the holds still open
(pending authorizations, scheduled payments, payment requests that reserve funds). Prints drifted accounts and what differs.
Exit code 1 if any drifted (and --fix not given). With --fix, rewrites drifted rows from the ledger and the open holds and exits 0.
Scheduler
Section titled “Scheduler”// routes/console.php (Laravel 11+) or app/Console/Kernel.php schedule()Schedule::command('wallet:process-scheduled')->daily();Schedule::command('wallet:reconcile')->dailyAt('03:00'); // non-zero exit on drift; hook into your alerting