Add Events Pro/Business and BYO ticket gateways.

Cut ticket checkouts off Ladill Pay, settle to merchant gateways at 0% platform fee, and mirror Invoice freemium pricing (GHS 49 / 149). Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-15 01:26:28 +00:00
parent dda52722ce
commit 4c87c786da
26 changed files with 1376 additions and 105 deletions
@@ -3,6 +3,8 @@
 namespace App\Services\Billing;

 use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use App\Models\User;

 /**
 * Client for the platform Billing HTTP API — the one UserWallet lives on the
@@ -84,4 +86,94 @@ class BillingClient

        return (array) $res->json();
    }
+
+    public function configured(): bool
+    {
+        return $this->base() !== '' && $this->token() !== '';
+    }
+
+    /**
+     * @return array{ok: bool, insufficient: bool, balance_minor: ?int, error: ?string}
+     */
+    public function charge(User $user, int $amountMinor, string $reference, string $description): array
+    {
+        if (! $this->configured()) {
+            return ['ok' => false, 'insufficient' => false, 'balance_minor' => null, 'error' => 'Billing is not configured.'];
+        }
+
+        try {
+            $res = Http::withToken($this->token())
+                ->acceptJson()->timeout(20)
+                ->post($this->base().'/debit', [
+                    'user' => $user->public_id,
+                    'amount_minor' => $amountMinor,
+                    'service' => (string) config('billing.service', 'events'),
+                    'source' => 'subscription',
+                    'reference' => $reference,
+                    'description' => $description,
+                ]);
+        } catch (\Throwable $e) {
+            Log::warning('Events BillingClient: charge failed', ['user' => $user->public_id, 'error' => $e->getMessage()]);
+
+            return ['ok' => false, 'insufficient' => false, 'balance_minor' => null, 'error' => 'Could not reach the billing service.'];
+        }
+
+        if ($res->status() === 402) {
+            return ['ok' => false, 'insufficient' => true, 'balance_minor' => (int) $res->json('balance_minor', 0), 'error' => 'Insufficient wallet balance.'];
+        }
+
+        if ($res->failed()) {
+            return ['ok' => false, 'insufficient' => false, 'balance_minor' => null, 'error' => 'Billing error ('.$res->status().').'];
+        }
+
+        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($this->token())
+            ->acceptJson()->timeout(15)
+            ->post($this->base().'/plan-checkout', [
+                'user' => $user->public_id,
+                'app' => (string) config('billing.service', 'events'),
+                '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($this->token())
+            ->acceptJson()->timeout(15)
+            ->post($this->base().'/plan-checkout/verify', [
+                'reference' => $reference,
+            ]);
+
+        if ($res->status() === 422) {
+            return ['paid' => false, 'error' => $res->json('error')];
+        }
+        $res->throw();
+
+        return $res->json();
+    }
 }