Aller au contenu

💳 Documentation Stripe / Paiements

Intégration Stripe et gestion des paiements en ligne

📋 Fichiers Disponibles

configuration.md

Configuration finale Stripe pour production - 5 méthodes de paiement actives - Configuration Dashboard Stripe - Tests et validation

payment-methods.md

Liste complète des méthodes de paiement Stripe - Méthodes disponibles - Configuration par méthode - Recommandations Boaz-Housing

methods-valid.md

Méthodes de paiement validées pour production - Méthodes actives - Temporairement désactivées - Erreurs corrigées

conversion-xaf-eur.md

Conversion automatique FCFA → EUR pour Stripe - Taux de conversion (1 EUR = 650 FCFA) - Flux technique - Cohérence système

webhook-testing.md

Tests webhooks Stripe - Configuration webhook - Tests locaux et production - Vérification signature

customization.md

Personnalisation interface Stripe Checkout - Branding - Couleurs et logo - Messages personnalisés

🎯 Configuration Actuelle

Mode : Production (Live keys)

Méthodes actives : - 💳 card - Cartes bancaires (Visa, Mastercard, Amex) - 💙 paypal - PayPal (Europe) - 🇳🇱 ideal - iDEAL (Pays-Bas) - 🇵🇱 p24 - Przelewy24 (Pologne) - 🇦🇹 eps - EPS (Autriche)

Conversion monétaire : FCFA → EUR (1 EUR = 650 FCFA)

🚀 Quick Start

Variables d'environnement

1
2
3
4
5
# Backend .env
STRIPE_SECRET_KEY=sk_live_VOTRE_CLE...
STRIPE_PUBLISHABLE_KEY=pk_live_VOTRE_CLE...
STRIPE_WEBHOOK_SECRET=whsec_VOTRE_SECRET
FRONTEND_URL=https://housing.boaz-study.tech

Tester un paiement

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# 1. Créer une souscription
POST /api/souscriptions/create-with-proforma

# 2. Initier paiement en ligne
POST /api/souscriptions/{id}/paiement-en-ligne

# 3. Redirection vers Stripe Checkout
# URL retournée → Client effectue paiement

# 4. Webhook confirmation
POST /api/souscriptions/webhook/stripe
# Statut souscription → ATTENTE_LIVRAISON

Vérifier configuration

1
2
3
4
5
6
7
8
# Tester webhook endpoint
curl -X POST https://api-housing.boaz-study.tech/api/souscriptions/webhook/stripe \
  -H "stripe-signature: test" \
  -d '{"type":"checkout.session.completed"}'

# Dashboard Stripe
# → Settings → Webhooks
# → Vérifier endpoint actif

📊 Flux de Paiement

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
1. Client clique "Payer en ligne"
   ↓
2. Backend crée session Stripe
   - Calcul montant (FCFA → EUR)
   - Génération checkout URL
   ↓
3. Redirection client vers Stripe
   ↓
4. Client choisit méthode paiement
   ↓
5. Client confirme paiement
   ↓
6. Stripe envoie webhook
   ↓
7. Backend traite webhook
   - Vérification signature
   - Update souscription
   - Statut → ATTENTE_LIVRAISON
   ↓
8. Redirection client vers dashboard
   ↓
9. Modal succès affichée

💰 Conversion FCFA → EUR

Service 1 - Attestation de Logement : 

1
2
160,000 FCFA ÷ 650 = 246.15 EUR
→ Stripe reçoit : 24,615 centimes

Voir détails : conversion-xaf-eur.md

🐛 Problèmes Courants

Webhook non reçu

Solutions : 1. Vérifier STRIPE_WEBHOOK_SECRET correcte 2. Vérifier endpoint accessible publiquement 3. Voir logs : docker logs boaz-backend | grep webhook

Erreur "Invalid payment method"

Solution : Vérifier méthode activée dans Dashboard Stripe

Montant incorrect

Solution : Vérifier conversion XAF→EUR dans conversion-xaf-eur.md

🔗 Liens Utiles

Maintenu par : Équipe Boaz-Housing Dev Dernière mise à jour : 01/10/2025