misaf/vendra-transaction

Wallet and ledger based financial transaction system with multi-gateway support, state-machine lifecycle and per-currency balances

v1.10.0 2026-08-01 01:25 UTC

Requires

• php: ^8.3
• flowframe/laravel-trend: ^0.5.0
• lara-zeus/spatie-translatable: ^2.0.1
• misaf/vendra-multimedia: v1.10.0
• misaf/vendra-support: v1.10.0
• spatie/eloquent-sortable: ^5.0.1
• spatie/laravel-activitylog: ^5.0
• spatie/laravel-model-states: ^2.11
• spatie/laravel-package-tools: ^1.93.1
• spatie/laravel-queueable-action: ^2.17
• spatie/laravel-sluggable: ^4.0.2

Requires (Dev)

• fakerphp/faker: ^1.24.1
• larastan/larastan: ^3.10.0
• laravel/boost: ^2.4.12
• laravel/pint: ^1.29.3
• misaf/vendra-currency: v1.10.0
• misaf/vendra-testing: v1.10.0
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.9.4
• orchestra/testbench: ^11.1
• pestphp/pest: ^5.0
• pestphp/pest-plugin-arch: ^5.0
• pestphp/pest-plugin-laravel: ^5.0
• pestphp/pest-plugin-profanity: ^5.0
• pestphp/pest-plugin-type-coverage: ^5.0
• phpstan/extension-installer: ^1.4.3

Suggests

• misaf/vendra-currency: Install this in the host application to manage active currencies used by wallet provisioning and transaction forms.

MIT

• Ehsan Mahmoodi

• laravel
• transaction
• filamentphp
• vendra
• misaf

Published on Packagist.org on 2026-08-01 01:29 UTC

README

Wallet and ledger based financial transactions for Vendra: per-user, per-currency wallet balances, an immutable ledger, a state-machine transaction lifecycle with multi-gateway support, and a Filament admin cluster for transactions, gateways, and wallets.

Features

1. Each user holds one Wallet per currency (created on first use via TransactionService::walletFor() / defaultWalletFor()), with a cached balance in the currency's minor units.
2. The ledger is the single source of balance truth: every movement is an immutable LedgerEntry (signed amount, balance_after snapshot, polymorphic source) written by PostLedgerEntryAction together with the cached wallet balance under a row lock. Overdrafts throw InsufficientBalanceException.
3. A Transaction is a gateway-facing money movement created through CreateTransactionAction::execute(), which enforces per-wallet TransactionLimits and attaches optional fee and metadata rows. Its amount is always absolute; the ledger sign derives from the transaction type (deposit, withdrawal, commission, transfer, bonus).
4. The lifecycle is a Spatie model-states machine: Pending → Processing → Review → Approved / Declined / Failed, driven by approve(), decline(), fail(), markProcessing(), and markReview(). Settlement into the ledger happens exactly once, inside the transition to Approved — principal, mirrored transfer credit, and fee commit atomically with the status change.
5. Gateways are admin-managed labels (translatable name and description, a scalar slug lookup key, logo, sortable position); payment-processing logic lives in the host application. Internal movements use the internal-transactions gateway.

The module is decoupled from concrete user and currency packages. The wallet owner model resolves from auth.providers.users.model; currency options resolve through the provider-neutral capability in misaf/vendra-support.

Requirements

• PHP 8.3+
• Laravel 13
• Filament 5
• misaf/vendra-support
• misaf/vendra-multimedia

Optional:

• misaf/vendra-currency — supplies managed active/default currency options to the shared Support resolver

Installation

composer require misaf/vendra-transaction
php artisan vendor:publish --tag=vendra-transaction-migrations
php artisan migrate

Optional translations publish:

php artisan vendor:publish --tag=vendra-transaction-translations

Balance verification

Recompute cached wallet balances from the ledger and report (or repair) drift:

php artisan vendra-transaction:verify-balances
php artisan vendra-transaction:verify-balances --repair

Testing

Run the package checks from the package directory:

composer test
composer analyse

License

MIT. See LICENSE.