🔧 Guide Webhook Stripe Connect

🎯 Pourquoi Modifier le Webhook ?

Avec Stripe Connect, votre webhook doit gérer des événements supplémentaires pour traquer correctement :

• ✅ Les commissions reçues (application_fee)
• ✅ Les transferts vers les vendeurs (transfer)
• ✅ Les métadonnées Stripe Connect

📋 Événements Stripe Connect à Surveiller

1. Événements Existants (à Conserver)

• checkout.session.completed - Session de paiement terminée
• payment_intent.succeeded - Paiement réussi

2. Nouveaux Événements Stripe Connect

• transfer.created - Transfer vers le vendeur créé
• application_fee.created - Votre commission reçue
• account.updated - Compte vendeur mis à jour

🔄 Migration du Webhook

Option 1 : Remplacer le Webhook Existant

# Supprimer l'ancien webhook
supabase functions delete stripe-webhook

# Déployer le nouveau webhook Stripe Connect
supabase functions deploy stripe-webhook-connect

Option 2 : Mettre à Jour l'Existant

Remplacer le contenu de supabase/functions/stripe-webhook/index.ts par le nouveau code.

📊 Nouvelles Données à Traquer

1. Dans la Table commandes

-- Ajouter ces colonnes si elles n'existent pas
ALTER TABLE commandes ADD COLUMN stripe_session_id TEXT;
ALTER TABLE commandes ADD COLUMN stripe_payment_intent_id TEXT;
ALTER TABLE commandes ADD COLUMN stripe_connect_destination TEXT;
ALTER TABLE commandes ADD COLUMN application_fee_amount INTEGER;
ALTER TABLE commandes ADD COLUMN commission_received DECIMAL(10,2);

2. Nouvelle Table commissions (Optionnelle)

CREATE TABLE commissions (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    commande_id UUID REFERENCES commandes(id),
    application_fee_id TEXT,
    amount DECIMAL(10,2),
    currency TEXT DEFAULT 'EUR',
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    status TEXT DEFAULT 'pending'
);

3. Nouvelle Table transfers (Optionnelle)

CREATE TABLE transfers (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    commande_id UUID REFERENCES commandes(id),
    transfer_id TEXT,
    destination_account TEXT,
    amount DECIMAL(10,2),
    currency TEXT DEFAULT 'EUR',
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    status TEXT DEFAULT 'pending'
);

🔧 Configuration Stripe Dashboard

1. Webhook Endpoints

• URL : https://votre-projet.supabase.co/functions/v1/stripe-webhook-connect
• Événements :
  • checkout.session.completed
  • payment_intent.succeeded
  • transfer.created
  • application_fee.created

2. Vérification des Événements

Dans le dashboard Stripe, vérifiez que tous les événements sont bien reçus.

🧪 Test du Webhook

1. Test avec Stripe CLI

# Écouter les événements en local
stripe listen --forward-to localhost:54321/functions/v1/stripe-webhook-connect

# Déclencher un événement de test
stripe trigger checkout.session.completed

2. Test en Production

1. Créer une commande de test
2. Effectuer un paiement
3. Vérifier les logs dans Supabase
4. Vérifier les données en base

📈 Monitoring et Logs

1. Logs à Surveiller

// Dans les logs Supabase, chercher :
console.log('Processing checkout.session.completed:', session.id);
console.log('Stripe Connect payment detected');
console.log('Application fee amount:', paymentIntent.application_fee_amount);
console.log('Transfer amount:', transfer.amount);

2. Métriques Importantes

• Nombre de paiements Stripe Connect
• Montant des commissions reçues
• Nombre de transferts vers les vendeurs
• Taux d'erreur des webhooks

⚠️ Points d'Attention

1. Gestion des Erreurs

• Vérifier que tous les événements sont traités
• Gérer les cas où commande_id est manquant
• Surveiller les échecs de mise à jour en base

2. Sécurité

• Vérifier la signature Stripe (déjà implémenté)
• Valider les données reçues
• Limiter les tentatives de retry

3. Performance

• Traiter les événements rapidement
• Éviter les timeouts
• Gérer la charge en cas de pic

🚀 Déploiement

1. Déploiement du Nouveau Webhook

# Déployer la nouvelle fonction
supabase functions deploy stripe-webhook-connect

# Mettre à jour l'URL dans Stripe Dashboard
# https://votre-projet.supabase.co/functions/v1/stripe-webhook-connect

2. Migration des Données

-- Mettre à jour les commandes existantes si nécessaire
UPDATE commandes 
SET payment_type = 'card' 
WHERE payment_type IS NULL;

3. Vérification Post-Déploiement

1. Tester un paiement complet
2. Vérifier les logs
3. Vérifier les données en base
4. Surveiller pendant 24h

📋 Checklist de Migration

• Nouveau webhook déployé
• Événements configurés dans Stripe Dashboard
• Colonnes ajoutées en base (si nécessaire)
• Test en local réussi
• Test en production réussi
• Monitoring configuré
• Documentation mise à jour

🎉 Résultat Final

Avec ce webhook mis à jour, vous pourrez :

• ✅ Traquer toutes les commissions reçues
• ✅ Surveiller les transferts vers les vendeurs
• ✅ Avoir une visibilité complète sur Stripe Connect
• ✅ Détecter les problèmes rapidement
• ✅ Optimiser votre système de paiement

Votre webhook est maintenant prêt pour Stripe Connect ! 🚀