feat: poll checkout status and show failures

tests/Feature/Tenant/TenantCheckoutSessionStatusTest.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Tests\Feature\Tenant;
+
+use App\Models\CheckoutSession;
+use App\Models\Package;
+use Illuminate\Support\Str;
+
+class TenantCheckoutSessionStatusTest extends TenantTestCase
+{
+    public function test_tenant_can_fetch_checkout_session_status(): void
+    {
+        $package = Package::factory()->create([
+            'price' => 129,
+        ]);
+
+        $session = CheckoutSession::create([
+            'id' => (string) Str::uuid(),
+            'user_id' => $this->tenantUser->id,
+            'tenant_id' => $this->tenant->id,
+            'package_id' => $package->id,
+            'status' => CheckoutSession::STATUS_FAILED,
+            'provider' => CheckoutSession::PROVIDER_PADDLE,
+            'status_history' => [
+                [
+                    'status' => CheckoutSession::STATUS_FAILED,
+                    'reason' => 'paddle_failed',
+                    'at' => now()->toIso8601String(),
+                ],
+            ],
+        ]);
+
+        $response = $this->authenticatedRequest(
+            'GET',
+            "/api/v1/tenant/packages/checkout-session/{$session->id}/status"
+        );
+
+        $response->assertOk()
+            ->assertJsonPath('status', CheckoutSession::STATUS_FAILED)
+            ->assertJsonPath('reason', 'paddle_failed');
+    }
+}

tests/Feature/Tenant/TenantPaddleCheckoutTest.php

@@ -29,7 +29,10 @@ class TenantPaddleCheckoutTest extends TenantTestCase
                 return $tenant->is($this->tenant)
                     && $payloadPackage->is($package)
                     && array_key_exists('success_url', $payload)
-                    && array_key_exists('return_url', $payload);
+                    && array_key_exists('return_url', $payload)
+                    && array_key_exists('metadata', $payload)
+                    && is_array($payload['metadata'])
+                    && ! empty($payload['metadata']['checkout_session_id']);
             })
             ->andReturn([
                 'checkout_url' => 'https://checkout.paddle.test/checkout/123',
@@ -42,7 +45,8 @@ class TenantPaddleCheckoutTest extends TenantTestCase
         ]);
 
         $response->assertOk()
-            ->assertJsonPath('checkout_url', 'https://checkout.paddle.test/checkout/123');
+            ->assertJsonPath('checkout_url', 'https://checkout.paddle.test/checkout/123')
+            ->assertJsonStructure(['checkout_session_id']);
     }
 
     public function test_paddle_checkout_requires_paddle_price_id(): void