Add Business tier and Paystack prepaid billing for POS.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Http/Controllers/Pos/ProController.php

@@ -3,6 +3,9 @@
 namespace App\Http\Controllers\Pos;
 
 use App\Http\Controllers\Controller;
+use App\Models\Pos\ProSubscription;
+use App\Models\User;
+use App\Services\Pos\BillingClient;
 use App\Services\Pos\SubscriptionService;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -15,12 +18,18 @@ class ProController extends Controller
     public function index(Request $request): View
     {
         $user = ladill_account() ?? $request->user();
+        $planKey = $this->subscriptions->planKey($user);
 
         return view('pos.pro.index', [
             'subscription' => $this->subscriptions->subscriptionFor($user),
-            'isPro' => $this->subscriptions->isPro($user),
+            'planKey' => $planKey,
+            'isPro' => $planKey === ProSubscription::PLAN_PRO,
+            'isEnterprise' => $planKey === ProSubscription::PLAN_ENTERPRISE,
+            'hasPaidPlan' => $this->subscriptions->hasPaidPlan($user),
             'gatingActive' => $this->subscriptions->gatingActive(),
-            'priceMinor' => $this->subscriptions->priceMinor(),
+            'proPriceMinor' => $this->subscriptions->priceMinor(),
+            'enterprisePriceMinor' => $this->subscriptions->enterprisePriceMinor(),
+            'prepaidMonths' => (array) config('pos.prepaid_months', [6, 12, 24]),
             'currency' => (string) config('pos.pro.currency', 'GHS'),
         ]);
     }
@@ -32,6 +41,92 @@ class ProController extends Controller
         return redirect()->route('pos.pro.index')->with($ok ? 'success' : 'error', $message);
     }
 
+    public function subscribeEnterprise(Request $request): RedirectResponse
+    {
+        [$ok, $message] = $this->subscriptions->subscribeEnterprise(ladill_account() ?? $request->user());
+
+        return redirect()->route('pos.pro.index')->with($ok ? 'success' : 'error', $message);
+    }
+
+    public function subscribePrepaid(Request $request, BillingClient $billing): RedirectResponse
+    {
+        $validated = $request->validate([
+            'plan' => ['required', 'in:pro,enterprise'],
+            'months' => ['required', 'integer', 'in:6,12,24'],
+        ]);
+
+        $user = ladill_account() ?? $request->user();
+        if ($this->subscriptions->hasPaidPlan($user)) {
+            return redirect()->route('pos.pro.index')
+                ->with('success', 'You already have an active subscription.');
+        }
+
+        $plan = $validated['plan'];
+        $months = (int) $validated['months'];
+        $monthlyMinor = $plan === 'enterprise'
+            ? $this->subscriptions->enterprisePriceMinor()
+            : $this->subscriptions->priceMinor();
+
+        try {
+            $checkout = $billing->initiatePlanCheckout(
+                $user,
+                $plan,
+                $months,
+                $monthlyMinor * $months,
+                route('pos.pro.paystack.callback'),
+                ['user_id' => $user->id],
+            );
+        } catch (\Throwable) {
+            return redirect()->route('pos.pro.index')
+                ->with('error', 'Could not start Paystack checkout. Please try again.');
+        }
+
+        $url = trim((string) ($checkout['checkout_url'] ?? ''));
+        if ($url === '') {
+            return redirect()->route('pos.pro.index')
+                ->with('error', 'Paystack did not return a checkout URL.');
+        }
+
+        return redirect()->away($url);
+    }
+
+    public function paystackCallback(Request $request, BillingClient $billing): RedirectResponse
+    {
+        $reference = (string) $request->query('reference', '');
+        if ($reference === '') {
+            return redirect()->route('pos.pro.index')->with('error', 'Missing payment reference.');
+        }
+
+        try {
+            $result = $billing->verifyPlanCheckout($reference);
+        } catch (\Throwable) {
+            return redirect()->route('pos.pro.index')
+                ->with('error', 'Could not verify payment. Contact support with reference: '.$reference);
+        }
+
+        if (! ($result['paid'] ?? false)) {
+            return redirect()->route('pos.pro.index')
+                ->with('error', 'Payment was not completed.');
+        }
+
+        $metadata = (array) ($result['metadata'] ?? []);
+        $user = User::query()->find((int) ($metadata['user_id'] ?? 0));
+        $account = ladill_account() ?? $request->user();
+        if (! $user || ! $account || $user->id !== $account->id) {
+            return redirect()->route('pos.pro.index')
+                ->with('error', 'Account not found for this payment.');
+        }
+
+        $plan = (string) ($result['plan'] ?? 'pro');
+        $months = (int) ($result['months'] ?? 0);
+        $this->subscriptions->activatePrepaid($user, $plan, $months);
+
+        $label = $plan === 'enterprise' ? 'POS Business' : 'POS Pro';
+
+        return redirect()->route('pos.pro.index')
+            ->with('success', "{$label} is active for {$months} months.");
+    }
+
     public function cancel(Request $request): RedirectResponse
     {
         [$ok, $message] = $this->subscriptions->cancel(ladill_account() ?? $request->user());

app/Models/Pos/ProSubscription.php

@@ -14,10 +14,14 @@ class ProSubscription extends Model
 
     public const STATUS_PAST_DUE = 'past_due';
 
+    public const PLAN_PRO = 'pro';
+
+    public const PLAN_ENTERPRISE = 'enterprise';
+
     protected $table = 'pos_pro_subscriptions';
 
     protected $fillable = [
-        'user_id', 'status', 'price_minor', 'currency', 'auto_renew',
+        'user_id', 'status', 'plan', 'price_minor', 'currency', 'auto_renew',
         'started_at', 'current_period_end', 'last_charged_at', 'canceled_at',
         'last_reference', 'last_error',
     ];

app/Providers/AppServiceProvider.php

@@ -30,9 +30,14 @@ class AppServiceProvider extends ServiceProvider
                 $restaurant = PosLocation::owned((string) $account->public_id)
                     ->where('service_style', PosLocation::STYLE_RESTAURANT)
                     ->exists();
-                $view->with('isPro', app(SubscriptionService::class)->isPro($account));
+                $svc = app(SubscriptionService::class);
+                $view->with('isPro', $svc->isPro($account));
+                $view->with('hasPaidPlan', $svc->hasPaidPlan($account));
+                $view->with('isEnterprise', $svc->isEnterprise($account));
             } else {
                 $view->with('isPro', false);
+                $view->with('hasPaidPlan', false);
+                $view->with('isEnterprise', false);
             }
             $view->with('posRestaurant', $restaurant);
         });

app/Services/Pos/BillingClient.php

@@ -49,4 +49,52 @@ class BillingClient
 
         return ['ok' => true, 'insufficient' => false, 'balance_minor' => null, 'error' => null];
     }
+
+    /**
+     * @param  array<string, mixed>  $metadata
+     * @return array{checkout_url: string, reference: string}
+     */
+    public function initiatePlanCheckout(
+        User $user,
+        string $plan,
+        int $months,
+        int $amountMinor,
+        string $returnUrl,
+        array $metadata = [],
+    ): array {
+        $res = Http::withToken((string) config('billing.api_key'))
+            ->acceptJson()->timeout(15)
+            ->post(rtrim((string) config('billing.api_url'), '/').'/plan-checkout', [
+                'user' => $user->public_id,
+                'app' => (string) config('billing.service', 'pos'),
+                'plan' => $plan,
+                'months' => $months,
+                'amount_minor' => $amountMinor,
+                'return_url' => $returnUrl,
+                'metadata' => $metadata,
+            ]);
+        $res->throw();
+
+        return [
+            'checkout_url' => (string) $res->json('checkout_url'),
+            'reference' => (string) $res->json('reference'),
+        ];
+    }
+
+    /** @return array<string, mixed> */
+    public function verifyPlanCheckout(string $reference): array
+    {
+        $res = Http::withToken((string) config('billing.api_key'))
+            ->acceptJson()->timeout(15)
+            ->post(rtrim((string) config('billing.api_url'), '/').'/plan-checkout/verify', [
+                'reference' => $reference,
+            ]);
+
+        if ($res->status() === 422) {
+            return ['paid' => false, 'error' => $res->json('error')];
+        }
+        $res->throw();
+
+        return $res->json();
+    }
 }

app/Services/Pos/SubscriptionService.php

@@ -21,7 +21,12 @@ class SubscriptionService
 
     public function priceMinor(): int
     {
-        return (int) config('pos.pro.price_minor', 7900);
+        return (int) config('pos.plans.pro.price_minor', config('pos.pro.price_minor', 7900));
+    }
+
+    public function enterprisePriceMinor(): int
+    {
+        return (int) config('pos.plans.enterprise.price_minor', 24900);
     }
 
     public function subscriptionFor(User $user): ?ProSubscription
@@ -29,7 +34,23 @@ class SubscriptionService
         return ProSubscription::where('user_id', $user->id)->first();
     }
 
-    public function isPro(User $user): bool
+    public function planKey(User $user): string
+    {
+        if (! $this->gatingActive()) {
+            return ProSubscription::PLAN_PRO;
+        }
+
+        $sub = $this->subscriptionFor($user);
+        if (! $sub || ! $sub->entitled()) {
+            return 'free';
+        }
+
+        return $sub->plan === ProSubscription::PLAN_ENTERPRISE
+            ? ProSubscription::PLAN_ENTERPRISE
+            : ProSubscription::PLAN_PRO;
+    }
+
+    public function hasPaidPlan(User $user): bool
     {
         if (! $this->gatingActive()) {
             return true;
@@ -38,6 +59,16 @@ class SubscriptionService
         return (bool) $this->subscriptionFor($user)?->entitled();
     }
 
+    public function isEnterprise(User $user): bool
+    {
+        return $this->planKey($user) === ProSubscription::PLAN_ENTERPRISE;
+    }
+
+    public function isPro(User $user): bool
+    {
+        return $this->hasPaidPlan($user);
+    }
+
     public function productCount(string $ownerRef, bool $restaurant): int
     {
         if ($restaurant) {
@@ -84,41 +115,56 @@ class SubscriptionService
     {
         $existing = $this->subscriptionFor($user);
         if ($existing && $existing->entitled() && $existing->status === ProSubscription::STATUS_ACTIVE) {
-            return [true, 'You are already on Ladill POS Pro.'];
+            return [true, 'You already have an active subscription.'];
         }
 
-        $price = $this->priceMinor();
-        $reference = 'pos-pro-'.$user->id.'-'.now()->format('YmdHis').'-'.Str::random(6);
-        $result = $this->billing->charge($user, $price, $reference, 'Ladill POS Pro — monthly subscription');
-
-        if (! $result['ok']) {
-            if ($result['insufficient']) {
-                $bal = number_format(((int) $result['balance_minor']) / 100, 2);
-
-                return [false, "Your wallet balance (GHS {$bal}) is too low. Top up, then subscribe."];
-            }
-
-            return [false, $result['error'] ?? 'Could not start your subscription. Please try again.'];
+        if ($existing?->plan === ProSubscription::PLAN_ENTERPRISE) {
+            return $this->subscribeEnterprise($user);
         }
 
-        $periodEnd = Carbon::now()->addDays((int) config('pos.pro.period_days', 30));
+        return $this->activateWalletPlan($user, ProSubscription::PLAN_PRO, $this->priceMinor(), 'Ladill POS Pro — monthly subscription', 'Welcome to Ladill POS Pro!');
+    }
+
+    /** @return array{0:bool,1:string} */
+    public function subscribeEnterprise(User $user): array
+    {
+        $existing = $this->subscriptionFor($user);
+        if ($existing && $existing->entitled() && $existing->status === ProSubscription::STATUS_ACTIVE) {
+            return [true, 'You already have an active subscription.'];
+        }
+
+        return $this->activateWalletPlan(
+            $user,
+            ProSubscription::PLAN_ENTERPRISE,
+            $this->enterprisePriceMinor(),
+            'Ladill POS Business — monthly subscription',
+            'Welcome to Ladill POS Business!',
+        );
+    }
+
+    public function activatePrepaid(User $user, string $plan, int $months): void
+    {
+        $existing = $this->subscriptionFor($user);
+        $price = $plan === ProSubscription::PLAN_ENTERPRISE
+            ? $this->enterprisePriceMinor()
+            : $this->priceMinor();
+
         ProSubscription::updateOrCreate(
             ['user_id' => $user->id],
             [
+                'plan' => $plan,
                 'status' => ProSubscription::STATUS_ACTIVE,
                 'price_minor' => $price,
                 'currency' => (string) config('pos.pro.currency', 'GHS'),
-                'auto_renew' => true,
+                'auto_renew' => false,
                 'started_at' => $existing?->started_at ?? now(),
-                'current_period_end' => $periodEnd,
+                'current_period_end' => Carbon::now()->addMonths($months),
                 'last_charged_at' => now(),
                 'canceled_at' => null,
-                'last_reference' => $reference,
+                'last_reference' => null,
                 'last_error' => null,
             ],
         );
-
-        return [true, 'Welcome to Ladill POS Pro! Your subscription is active.'];
     }
 
     /** @return array{0:bool,1:string} */
@@ -137,7 +183,7 @@ class SubscriptionService
 
         $until = optional($sub->current_period_end)->format('d M Y');
 
-        return [true, "Auto-renew is off. You keep Pro until {$until}."];
+        return [true, "Auto-renew is off. You keep access until {$until}."];
     }
 
     public function renewIfDue(ProSubscription $sub): void
@@ -154,8 +200,9 @@ class SubscriptionService
             return;
         }
 
-        $reference = 'pos-pro-'.$user->id.'-'.now()->format('YmdHis').'-'.Str::random(6);
-        $result = $this->billing->charge($user, $sub->price_minor, $reference, 'Ladill POS Pro — renewal');
+        $planLabel = $sub->plan === ProSubscription::PLAN_ENTERPRISE ? 'Business' : 'Pro';
+        $reference = 'pos-'.$sub->plan.'-'.$user->id.'-'.now()->format('YmdHis').'-'.Str::random(6);
+        $result = $this->billing->charge($user, $sub->price_minor, $reference, "Ladill POS {$planLabel} — renewal");
 
         if ($result['ok']) {
             $sub->forceFill([
@@ -175,4 +222,42 @@ class SubscriptionService
             $sub->forceFill(['last_error' => $result['error']])->save();
         }
     }
+
+    /** @return array{0:bool,1:string} */
+    private function activateWalletPlan(User $user, string $plan, int $price, string $description, string $successMessage): array
+    {
+        $existing = $this->subscriptionFor($user);
+        $reference = 'pos-'.$plan.'-'.$user->id.'-'.now()->format('YmdHis').'-'.Str::random(6);
+        $result = $this->billing->charge($user, $price, $reference, $description);
+
+        if (! $result['ok']) {
+            if ($result['insufficient']) {
+                $bal = number_format(((int) $result['balance_minor']) / 100, 2);
+
+                return [false, "Your wallet balance (GHS {$bal}) is too low. Top up, then subscribe."];
+            }
+
+            return [false, $result['error'] ?? 'Could not start your subscription. Please try again.'];
+        }
+
+        $periodEnd = Carbon::now()->addDays((int) config('pos.pro.period_days', 30));
+        ProSubscription::updateOrCreate(
+            ['user_id' => $user->id],
+            [
+                'plan' => $plan,
+                'status' => ProSubscription::STATUS_ACTIVE,
+                'price_minor' => $price,
+                'currency' => (string) config('pos.pro.currency', 'GHS'),
+                'auto_renew' => true,
+                'started_at' => $existing?->started_at ?? now(),
+                'current_period_end' => $periodEnd,
+                'last_charged_at' => now(),
+                'canceled_at' => null,
+                'last_reference' => $reference,
+                'last_error' => null,
+            ],
+        );
+
+        return [true, $successMessage.' Your subscription is active.'];
+    }
 }