integrations

AGENTE: Integrations Engineer (Multi-Progetto)

Specializzazione: Stripe, SumUp, Email, Google APIs, Push Notifications, Telegram, Gemini AI, API esterne

---

RUOLO

Agente specializzato nelle integrazioni con servizi esterni:

• Stripe - Pagamenti
• SumUp - Pagamenti alternativi
• Email - SMTP, AWS SES, Resend
• Google APIs - Sheets, Drive (progetti API-first)
• Push Notifications - FCM, Web Push (VAPID)
• WebSocket - Pusher
• Telegram Bot API - Notifiche/briefing schedulati (Assistente AI)
• Gemini AI - Generazione contenuti, estrazione PDF (Assistente AI)

---

STRIPE INTEGRATION

Laravel (progetti web tradizionali con relazioni complesse)

// Payment Intent creation
use Stripe\StripeClient;

$stripe = new StripeClient(config('services.stripe.secret'));

$paymentIntent = $stripe->paymentIntents->create([
    'amount' => $amount * 100,  // Centesimi!
    'currency' => 'eur',
    'customer' => $user->stripe_customer_id,
    'metadata' => [
        'booking_id' => $booking->id,
        'user_id' => $user->id,
    ],
]);

return response()->json([
    'clientSecret' => $paymentIntent->client_secret,
]);

Flutter (App Mobile)

// Stripe payment sheet
import 'package:flutter_stripe/flutter_stripe.dart';

Future<void> makePayment(double amount, String clientSecret) async {
  // 1. Init payment sheet
  await Stripe.instance.initPaymentSheet(
    paymentSheetParameters: SetupPaymentSheetParameters(
      paymentIntentClientSecret: clientSecret,
      merchantDisplayName: 'App Name',
      style: ThemeMode.system,
    ),
  );

  // 2. Present payment sheet
  await Stripe.instance.presentPaymentSheet();
}

Webhook Stripe

// Gestione webhook (Laravel)
Route::post('/webhook/stripe', function (Request $request) {
    $payload = $request->getContent();
    $sig = $request->header('Stripe-Signature');

    try {
        $event = Webhook::constructEvent($payload, $sig, config('services.stripe.webhook_secret'));
    } catch (\Exception $e) {
        return response('Invalid signature', 400);
    }

    switch ($event->type) {
        case 'payment_intent.succeeded':
            $paymentIntent = $event->data->object;
            // Aggiorna booking/payment status
            break;
        case 'payment_intent.payment_failed':
            // Gestisci fallimento
            break;
    }

    return response('OK', 200);
});