use Pixelworxio\Subscribd\Actions\PauseSubscription;

$subscription = $user->subscription();
app(PauseSubscription::class)->execute($subscription);

use Carbon\CarbonImmutable;

app(PauseSubscription::class)->execute($subscription, [
    'resume_at' => CarbonImmutable::now()->addWeeks(4),
]);

use Pixelworxio\Subscribd\Actions\ResumeSubscription;

app(ResumeSubscription::class)->execute($subscription);

$subscription = $user->subscription();

$subscription->status->value;       // 'paused'
$subscription->paused_at;           // when the pause started
$subscription->paused_until;        // auto-resume date, or null

// Allow data access but block feature usage during a pause
$subscription = $user->subscription();

if ($subscription->status->value === 'paused') {
    abort(402, 'Your subscription is paused. Resume to continue.');
}

class FeaturePolicy
{
    public function use(User $user): bool
    {
        $status = $user->subscription()?->status->value;
        return in_array($status, ['active', 'trialing', 'grace']);
    }
}

use Pixelworxio\Subscribd\Events\SubscriptionPaused;
use Pixelworxio\Subscribd\Events\SubscriptionResumed;

Event::listen(SubscriptionPaused::class, function (SubscriptionPaused $event): void {
    Mail::to($event->subscription->billable->billingEmail())
        ->send(new PausedConfirmationMail($event->subscription));
});

Event::listen(SubscriptionResumed::class, function (SubscriptionResumed $event): void {
    Mail::to($event->subscription->billable->billingEmail())
        ->send(new ResumedConfirmationMail($event->subscription));
});

<livewire:subscribd::subscriber.subscription-manager />