README

Abandoned cart capture, inactivity detection, recovery tracking and conversion recording for Laravel 12 and 13.

Features

Store cart snapshots using a stable host-application cart_key.
Optional polymorphic customer association.
Configurable inactivity threshold.
Mark stale carts as abandoned.
Unique recovery tokens and token lookup.
Record recovery and order conversion.
Query abandoned carts by date range.
Configurable table prefix.

Requirements

PHP 8.3+
Laravel 12 or 13

Installation

composer require itmosoft/laravel-abandoned-carts
php artisan vendor:publish --tag=itmosoft-abandoned-carts-config
php artisan migrate

The migration creates itmosoft_abandoned_carts by default. Configure table_prefix before running migrations if you need a different table name.

Capture or refresh a cart

use ItmoSoft\AbandonedCarts\AbandonedCartManager;

$manager = app(AbandonedCartManager::class);

$record = $manager->capture(
    cartKey: (string) $cart->id,
    items: [
        ['product_id' => 10, 'sku' => 'SKU-10', 'name' => 'Example', 'quantity' => 2, 'unit_price' => '25.00'],
    ],
    subtotal: '50.00',
    customer: auth()->user(),
    currency: 'USD',
    metadata: ['source' => 'web'],
);

Pass a stable unique key for the cart from your application. The items argument should be a serializable snapshot. The package does not depend on or modify a particular cart package.

Detect abandoned carts

Schedule the manager method in your application's scheduler. For example, call it hourly:

use Illuminate\Support\Facades\Schedule;
use ItmoSoft\AbandonedCarts\AbandonedCartManager;

Schedule::call(fn () => app(AbandonedCartManager::class)->markAbandoned())
    ->hourly();

The default threshold is 60 minutes since last_activity_at. Configure abandon_after_minutes in config/itmosoft-abandoned-carts.php.

Recovery and conversion

$record = $manager->findByRecoveryToken($token);

if ($record) {
    $manager->markRecovered($record);
}

// After the order is successfully created:
$manager->markConverted($record, (string) $order->getKey());

Use recovery_token to build a signed or otherwise protected recovery URL in your application. Do not expose cart snapshots or customer information solely because a token is present without applying your application's authorization and expiry rules.

Query abandoned carts

$abandoned = $manager->abandoned(
    now()->subDays(7),
    now(),
)->latest('abandoned_at')->get();

Important scope and production notes

This package stores snapshots; it does not integrate automatically with itmosoft/laravel-cart or any other cart implementation.
The host application must call capture() whenever cart contents or activity change, and must schedule markAbandoned().
It does not send email/SMS/push reminders, generate signed URLs, restore cart contents, or create orders.
The package does not implement campaign frequency caps, consent management, GDPR/data-retention workflows, multi-tenant scopes, or per-customer deduplication. Add these policies in the host application.
cart_key is unique and must be stable. Use a suitable opaque identifier; do not use raw session secrets.
The subtotal is stored as a decimal string/decimal database value; the package does not calculate tax, shipping, discounts, or currency conversion.
Recovery tokens are random, stored as plaintext and intended as opaque lookup tokens. Protect recovery endpoints with HTTPS, rate limiting, expiry/authorization checks and consider hashing tokens at rest for higher-security deployments.
Concurrent capture calls for the same new cart_key can race at the unique constraint. Handle duplicate-key retries in the host app if concurrent writes are possible.
markAbandoned() uses a bulk update; it does not dispatch per-record Eloquent model events.

Testing

composer install
composer validate --strict
composer test

License

MIT. See LICENSE.

itmosoft / laravel-abandoned-carts

Package info

Security

Statistics