Add Pagarme integration for "Codando com IA" course

- Implemented payment flow via Pagarme for the live course "Codando com IA" without granting access or sending emails.
- Created a new migration to ensure the plan exists in the database.
- Added a new request class for validating checkout link creation.
- Updated PagarmeController to handle the new checkout link and order status.
- Enhanced webhook handling to create users and subscriptions based on order events.
- Added tests for the webhook lifecycle to ensure proper functionality.

This update lays the groundwork for managing course payments and user subscriptions effectively.

Author: robertotcestari

.claude/pagarme-codando-com-ia-plan.md

@@ -0,0 +1,71 @@
+## Escopo
+
+Implementar e ajustar o fluxo de pagamento via Pagarme (Core v5 Orders + Checkout) para o curso ao vivo “Codando com IA”, sem liberar área de acesso ou enviar e-mails por enquanto, garantindo associação/criação de usuário e notificações no Discord.
+
+## Requisitos Confirmados
+
+- **Preço:** R$ 588,00 (58800 centavos), parcelamento em até 12x sem juros.
+- **Métodos de pagamento:** cartão de crédito, boleto e pix.
+- **Acesso/e-mails:** nenhum acesso adicional nem e-mails de confirmação neste momento.
+- **Usuário:** reutilizar usuário existente pelo e-mail ou criar um novo se não existir.
+- **Webhooks:** reutilizar o fluxo já existente, com tratamento específico para o produto do curso.
+- **URLs e metadados:** `success_url` = `/curso-ao-vivo/codando-com-ia/sucesso`; `product_slug` = `curso-ao-vivo-codando-com-ia-v1`.
+
+## Estado Atual
+
+- **POST `/api/pagarme/codando-com-ia/checkout`** já cria a Order + Checkout, retornando `payment_url`.
+- **GET `/api/pagarme/codando-com-ia/orders/{orderId}`** consulta a Order no Core v5, validando `product_slug`.
+- **POST `/api/pagarme/notification`** processa webhooks; atualmente o fluxo é focado em Subscription e apenas registra quando não encontra subscription para este produto.
+
+## Plano de Implementação
+
+### 1. Plano (`codando-com-ia-v1`)
+
+- Garantir via seed/migração idempotente a existência do plano com:
+  - `slug`: `codando-com-ia-v1`
+  - `name`: `Codando com IA (Ao Vivo) v1`
+  - `price_in_cents`: `58800`
+  - `duration_in_months`: `0`
+  - `details`: JSON opcional
+
+### 2. Checkout (`POST /api/pagarme/codando-com-ia/checkout`)
+
+- Sanitizar telefone (já implementado) e aceitar ausência sem falhar.
+- Localizar usuário pelo e-mail; se não existir, criar com nome, e-mail, telefone (se válido) e senha aleatória hasheada; atualizar dados faltantes quando reaproveitar usuários.
+- Incluir `customer.metadata.user_id` no payload enviado ao Pagarme.
+- Manter preço, métodos aceitos, parcelas sem juros, `success_url` e metadados existentes.
+- Após sucesso na criação da Order:
+  - Criar `Subscription` vinculada ao plano `codando-com-ia-v1` com `status = pending`, `acquisition_type = purchase`, `provider_id = order.id`, `price_paid_in_cents = order.amount` e `payment_method = null` (até atualização via webhook).
+- Retornar `checkoutLink`, `pagarmeOrderID`, `amount`, `status` (sem autenticar/logar o usuário nem disparar e-mails).
+
+### 3. Status (`GET /api/pagarme/codando-com-ia/orders/{orderId}`)
+
+- Manter lógica atual de validação do `product_slug` e retorno filtrado dos dados da Order.
+
+### 4. Webhooks (`POST /api/pagarme/notification`)
+
+- Para eventos `order.*` onde `metadata.product_slug === curso-ao-vivo-codando-com-ia-v1` ou Subscription vinculada ao plano `codando-com-ia-v1`:
+  - `findOrCreate` do `User` (atualizando nome/telefone ausentes).
+  - Localizar ou criar a `Subscription` pendente vinculada ao plano.
+  - Atualizar `status` e campos `payment_method`, `boleto_url`, `boleto_barcode` / `qr_code` diretamente (não usar `changeStatus` para evitar `upgradeUserToPro`).
+  - Enviar mensagem ao Discord no canal `notificacoes-compras` com resumo do evento (comprador, método, valor, `orderId`, status e contexto).
+  - Não liberar acesso, não enviar e-mails.
+  - Garantir idempotência atualizando apenas dados necessários.
+
+### 5. Segurança e Resiliência
+
+- Manter uso de Basic Auth para chamadas à API Pagarme.
+- Tolerar telefones inválidos/vazios sem lançar exceções.
+- Preservar e detalhar logs de erro no checkout.
+
+### 6. Testes Automatizados
+
+- **Checkout:** garantir criação/associação do usuário e subscription pendente, além do retorno do `payment_url`.
+- **Status:** confirmar 200 quando o `product_slug` bate e 404 caso contrário.
+- **Webhooks:** simular `order.created`, `order.closed`, `order.paid`, `order.canceled/failed` para validar atualizações da subscription, criação/atualização de usuário e envio de notificações ao Discord (mockado), assegurando que não há promoção a PRO.
+
+### 7. Pós-Implementação
+
+- Rodar migration/seed para criar o plano.
+- Executar `php artisan test` para validar o backend.
+- Certificar que o webhook do Pagarme aponta para `/api/pagarme/notification` e que `PAGARME_API_KEY` correta está configurada no `.env` de cada ambiente.

app/Http/Controllers/PagarmeController.php

@@ -2,22 +2,21 @@
 
 namespace App\Http\Controllers;
 
+use App\Http\Requests\CreateCheckoutLinkV2Request;
 use App\Http\Resources\SubscriptionResource;
 use App\Mail\PaymentConfirmed;
 use App\Models\Coupon;
 use App\Models\Plan;
+use App\Models\Subscription;
+use App\Models\User;
 use Carbon\Carbon;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Http;
-use Illuminate\Support\Str;
-use Mail;
+use Illuminate\Support\Facades\Mail;
 
 class PagarmeController extends Controller
 {
-    private const CODANDO_COM_IA_PRICE_IN_CENTS = 58800;
-    private const CODANDO_COM_IA_PRODUCT_SLUG = 'curso-ao-vivo-codando-com-ia-v1';
-
     public function __construct()
     {
         $this->middleware('auth:sanctum')->only([
@@ -26,177 +25,9 @@ public function __construct()
         ]);
     }
 
-    public function createCodandoComIaCheckout(Request $request)
-    {
-        $validated = $request->validate([
-            'name' => 'required|string|max:255',
-            'email' => 'required|email',
-            'phone' => 'required|string|max:30',
-            'tag' => 'nullable|string|max:255',
-        ]);
-
-        $rawPhone = preg_replace('/\D/', '', $validated['phone']);
-
-        if (Str::startsWith($rawPhone, '55') && strlen($rawPhone) > 11) {
-            $rawPhone = substr($rawPhone, 2);
-        }
-
-        $phonesPayload = null;
-
-        if (strlen($rawPhone) >= 10) {
-            $areaCode = substr($rawPhone, 0, 2);
-            $number = substr($rawPhone, 2);
-
-            $phonesPayload = [
-                'country_code' => '55',
-                'area_code' => $areaCode,
-                'number' => $number,
-            ];
-        }
-
-        $customerPayload = [
-            'name' => $validated['name'],
-            'email' => $validated['email'],
-            'type' => 'individual',
-            'metadata' => [
-                'product_slug' => self::CODANDO_COM_IA_PRODUCT_SLUG,
-                'lead_tag' => $validated['tag'] ?? null,
-            ],
-        ];
-
-        if ($phonesPayload) {
-            $customerPayload['phones'] = [
-                'mobile_phone' => $phonesPayload,
-            ];
-        }
-
-        $installments = collect(range(1, 12))->map(function ($number) {
-            return [
-                'number' => $number,
-                'total' => self::CODANDO_COM_IA_PRICE_IN_CENTS,
-            ];
-        })->values()->all();
-
-        $checkoutPayload = [
-            'code' => 'codando-com-ia-'.Str::uuid()->toString(),
-            'customer' => $customerPayload,
-            'items' => [
-                [
-                    'id' => 'codando-com-ia',
-                    'amount' => self::CODANDO_COM_IA_PRICE_IN_CENTS,
-                    'description' => 'Curso Codando com IA - Compra Única',
-                    'quantity' => 1,
-                    'code' => self::CODANDO_COM_IA_PRODUCT_SLUG,
-                ],
-            ],
-            'payments' => [
-                [
-                    'payment_method' => 'checkout',
-                    'checkout' => [
-                        'customer_editable' => true,
-                        'accepted_payment_methods' => [
-                            'credit_card',
-                            'boleto',
-                            'pix',
-                        ],
-                        'success_url' => config('app.frontend_url').'/curso-ao-vivo/codando-com-ia/sucesso',
-                        'pix' => [
-                            'expires_in' => 86400,
-                        ],
-                        'boleto' => [
-                            'due_at' => Carbon::now()
-                                ->addDays(3)
-                                ->toIso8601String(),
-                        ],
-                        'credit_card' => [
-                            'installments' => $installments,
-                            'operation_type' => 'auth_and_capture',
-                        ],
-                    ],
-                ],
-            ],
-            'metadata' => [
-                'product_slug' => self::CODANDO_COM_IA_PRODUCT_SLUG,
-                'lead_phone' => $validated['phone'],
-                'lead_tag' => $validated['tag'] ?? null,
-                'lead_email' => $validated['email'],
-                'lead_name' => $validated['name'],
-                'lead_phone_digits' => $phonesPayload
-                    ? $phonesPayload['area_code'].$phonesPayload['number']
-                    : null,
-            ],
-        ];
-
-        $response = Http::withBasicAuth(
-            config('services.pagarme.api_key'),
-            ''
-        )->post('https://api.pagar.me/core/v5/orders', $checkoutPayload);
-
-        if ($response->failed()) {
-            $status = $response->status();
-            $errorPayload = $response->json();
-
-            logger()->error('Pagarme order checkout creation failed', [
-                'status' => $status,
-                'payload' => $checkoutPayload,
-                'response' => $errorPayload,
-                'response_body' => $response->body(),
-            ]);
-
-            return response()->json([
-                'message' => 'Não foi possível iniciar o checkout no momento.',
-                'details' => $errorPayload,
-            ], $status > 0 ? $status : 400);
-        }
-
-        $order = $response->json();
-
-        return [
-            'checkoutLink' => $order['checkouts'][0]['payment_url'] ?? null,
-            'pagarmeOrderID' => $order['id'] ?? null,
-            'amount' => $order['amount'] ?? self::CODANDO_COM_IA_PRICE_IN_CENTS,
-            'status' => $order['status'] ?? null,
-        ];
-    }
-
-    public function getCodandoComIaOrderStatus(string $orderId)
-    {
-        $endpoint = "https://api.pagar.me/core/v5/orders/{$orderId}";
-
-        $response = Http::withBasicAuth(
-            config('services.pagarme.api_key'),
-            ''
-        )->get($endpoint);
-
-        if ($response->failed()) {
-            $status = $response->status();
-
-            return response()->json([
-                'message' => 'Não foi possível recuperar o status do pedido.',
-            ], $status > 0 ? $status : 400);
-        }
-
-        $order = $response->json();
-        $productSlug = $order['metadata']['product_slug'] ?? null;
-
-        if ($productSlug !== self::CODANDO_COM_IA_PRODUCT_SLUG) {
-            return response()->json(['message' => 'Pedido não encontrado'], 404);
-        }
-
-        return [
-            'id' => $order['id'] ?? null,
-            'status' => $order['status'] ?? null,
-            'amount' => $order['amount'] ?? null,
-            'charges' => $order['charges'] ?? [],
-            'customer' => [
-                'name' => $order['customer']['name'] ?? null,
-                'email' => $order['customer']['email'] ?? null,
-            ],
-        ];
-    }
-
     public function createOrderAndGetCheckoutLink(Request $request)
     {
+
         $plan_id = $request->plan_id ?? 1;
         $user = Auth::user();
         $plan = Plan::find($plan_id);
@@ -209,14 +40,14 @@ public function createOrderAndGetCheckoutLink(Request $request)
             $planDetails->user_raised_count * 10 * 100;
 
         $couponCode = $request->coupon;
-        $coupon = (new Coupon())->getValidCoupon($couponCode, $plan_id);
+        $coupon = (new Coupon)->getValidCoupon($couponCode, $plan_id);
 
         if ($coupon) {
             $promoPrice =
                 $coupon->type === 'percentage'
-                    ? $promoPrice -
-                        ($promoPrice * $coupon->discount_amount) / 100
-                    : $promoPrice - $coupon->discount_amount;
+                ? $promoPrice -
+                ($promoPrice * $coupon->discount_amount) / 100
+                : $promoPrice - $coupon->discount_amount;
         }
 
         $endpoint = 'https://api.pagar.me/core/v5/orders';
@@ -253,7 +84,7 @@ public function createOrderAndGetCheckoutLink(Request $request)
                             'boleto',
                             'pix',
                         ],
-                        'success_url' => config('app.frontend_url').'/assine/sucesso',
+                        'success_url' => config('app.frontend_url') . '/assine/sucesso',
                         'pix' => [
                             'expires_in' => 86400,
                         ],
@@ -341,6 +172,84 @@ public function createOrderAndGetCheckoutLink(Request $request)
         ];
     }
 
+    // Esse é o novo checkout link do Pagarme.
+    public function createCheckoutLinkV2(CreateCheckoutLinkV2Request $request)
+    {
+
+        $environment = config('app.env');
+        $endpoint = 'https://api.pagar.me/core/v5/paymentlinks';
+
+        if ($environment != 'production') {
+            $endpoint = 'https://sdx-api.pagar.me/core/v5/paymentlinks';
+        }
+
+        // get with plan_slug:
+
+        $payload = $this->buildCheckoutLinkV2Payload($request);
+
+        $response = Http::withBasicAuth(
+            config('services.pagarme.api_key'),
+            ''
+        )->post($endpoint, $payload);
+
+        return $response->json();
+    }
+
+    private function buildCheckoutLinkV2Payload(CreateCheckoutLinkV2Request $request)
+    {
+        $validated = $request->validated();
+
+        $plan = Plan::where('slug', $validated['plan_slug'])->firstOrFail();
+
+        $acceptedPaymentMethods = $validated['accepted_payment_methods'] ?? [
+            'credit_card',
+            'boleto',
+            'pix',
+        ];
+
+        $installmentsSetup = [
+            'interest_type' => 'simple',
+            'max_installments' => 12,
+            'amount' => $plan->price_in_cents,
+            'interest_rate' => 0,
+        ];
+
+        $boletoSettings = [
+            'due_in' => 2,
+        ];
+
+        $pixSettings = [
+            'expires_in' => 4,
+        ];
+
+        $items = [
+            [
+                'name' => $plan->name,
+                'amount' => $plan->price_in_cents,
+                'description' => $validated['plan_description'] ?? '',
+                'default_quantity' => 1,
+            ],
+        ];
+
+        return [
+            'name' => $plan->slug,
+            'is_building' => false,
+            'payment_settings' => [
+                'accepted_payment_methods' => $acceptedPaymentMethods,
+                'credit_card_settings' => [
+                    'installments_setup' => $installmentsSetup,
+                    'operation_type' => 'auth_and_capture',
+                ],
+                'boleto_settings' => $boletoSettings,
+                'pix_settings' => $pixSettings,
+            ],
+            'cart_settings' => [
+                'items' => $items,
+            ],
+            'type' => 'order',
+        ];
+    }
+
     // Função para retornar na página de sucesso.
     // Vamos pegar também o status dela para saber se foi pago ou não.
     public function getSubscriptionByPagarmeOrderId($pagarmeOrderID)