🎨 Guide de Customisation Stripe - Boaz Housing¶

✅ Améliorations Implémentées¶

🎯 1. Méthodes de Paiement Étendues¶

Avant : Seulement les cartes bancaires Maintenant : 7 méthodes de paiement européennes

payment_method_types=[
    'card',           # Cartes bancaires (Visa, Mastercard, American Express)
    'sepa_debit',     # Prélèvement SEPA (Europe)
    'bancontact',     # Bancontact (Belgique)
    'ideal',          # iDEAL (Pays-Bas)
    'giropay',        # Giropay (Allemagne)
    'sofort',         # SOFORT (Europe)
    'p24',            # Przelewy24 (Pologne)
]

🏠 2. Branding et Logo Produit¶

Nom du produit : "🏠 Souscription Boaz Housing {référence}"
Description personnalisée : "Réservation de logement étudiant"
Logo produit : Intégré dans le checkout via images
Descripteur de relevé : "BOAZ STUDY*" + référence

👤 3. Expérience Client Personnalisée¶

Création automatique de clients : customer_creation='always'
Email pré-rempli : Automatique depuis la souscription
Collecte d'adresses : Facturation obligatoire + expédition pour l'Europe
Pays autorisés : France, Belgique, Suisse, Luxembourg, Monaco, etc.

📝 4. Textes Personnalisés¶

Message de soumission : Information sur la sécurité et la réception d'attestation
Message d'adresse : Explication pour les documents officiels
Expiration de session : 30 minutes de sécurité

📊 5. Métadonnées Enrichies¶

Toutes les informations importantes sont sauvegardées : - ID et référence souscription - Nom complet du client - Type de service - Taux de conversion XAF→EUR - Email de support

🔧 Configuration Manuelle Stripe Dashboard¶

1. Logo Principal (Dashboard)¶

Aller sur https://dashboard.stripe.com/settings/branding
Télécharger le logo Boaz Study :
- Format : JPG ou PNG
- Taille : < 512KB
- Résolution : minimum 128px × 128px
Configurer les couleurs de marque

2. Logo Produit (Assets Web)¶

Le logo doit être accessible publiquement à :

1	`https://housing.boaz-study.tech/assets/logo-boaz-study.png`

Action requise : Placer le fichier logo dans le dossier public du frontend

3. Méthodes de Paiement (Dashboard)¶

Aller sur https://dashboard.stripe.com/settings/payment_methods
Activer les méthodes souhaitées :
- ✅ Cards (déjà activé)
- ✅ SEPA Direct Debit
- ✅ Bancontact
- ✅ iDEAL
- ✅ Giropay
- ✅ SOFORT
- ✅ Przelewy24

🎨 Personnalisation Avancée Disponible¶

Customisation Couleurs (Dashboard)¶

Couleur de marque : Utilisée sur les reçus et factures
Couleur d'accent : Arrière-plan des emails et pages

Domaine Personnalisé (Optionnel)¶

Utiliser pay.boaz-study.tech au lieu de checkout.stripe.com
Configuration via Dashboard > Settings > Custom Domain

Autres Options Avancées¶

Taxes automatiques : Désactivé (peut être activé si nécessaire)
Champs personnalisés : Possible d'ajouter des questions
Politiques : Retour/remboursement configurables

🧪 Test de la Customisation¶

Vérifications à Effectuer¶

Logo visible : Le logo apparaît-il sur la page de checkout ?
Méthodes de paiement : Toutes les méthodes sont-elles disponibles ?
Textes personnalisés : Les messages s'affichent-ils correctement ?
Métadonnées : Les informations sont-elles sauvegardées après paiement ?
Expérience mobile : Le checkout est-il optimisé sur mobile ?

URLs de Test¶

Succès : /admin-dashboard?payment_success=true&session_id={CHECKOUT_SESSION_ID}
Annulation : /admin-dashboard?payment_cancelled=true

📈 Avantages de la Customisation¶

💼 Professionnel¶

Cohérence de marque avec Boaz Study
Confiance client renforcée
Experience utilisateur premium

🌍 International¶

Support natif des méthodes de paiement européennes
Collecte d'adresses multi-pays
Conformité RGPD

🔒 Sécurité¶

Création automatique de clients Stripe
Session expirable (30 min)
Métadonnées complètes pour audit

📱 Conversion¶

Interface optimisée mobile
Méthodes de paiement locales
Messages rassurants sur la sécurité

📋 Actions Requises¶

✅ Implémenté¶

Code Stripe service avec customisation complète
Méthodes de paiement étendues
Textes personnalisés
Métadonnées enrichies
Configuration de branding

🔄 À Finaliser¶

Placer logo dans /frontend/public/assets/logo-boaz-study.png
Activer méthodes de paiement dans Stripe Dashboard
Configurer branding dans Dashboard
Tester checkout complet

🎯 Résultat Final¶

Avec ces améliorations, le checkout Stripe de Boaz Housing offre maintenant : - 7 méthodes de paiement au lieu d'1 - Logo et branding cohérents - Experience personnalisée selon la région - Métadonnées complètes pour le suivi - Interface professionnelle optimisée conversion