Tutoriel : Stripe pour les paiements internationaux

Stripe au Sénégal : ce qu’il faut savoir avant de commencer

Stripe est le géant mondial du paiement en ligne, utilisé par des millions de sites. Mais il y a un point crucial à comprendre : Stripe n’est pas disponible directement au Sénégal en 2026. Vous ne pouvez pas créer un compte Stripe avec une adresse sénégalaise et recevoir des fonds sur un compte bancaire local.

Alors pourquoi en parler ? Parce que de nombreux e-commerçants sénégalais ont besoin d’accepter des paiements internationaux — clients de la diaspora en France, Belgique, Canada, ou clients étrangers. Et pour ça, Stripe reste la meilleure solution si vous avez un moyen d’y accéder.

Les 3 façons d’utiliser Stripe depuis le Sénégal

Option 1 : Passer par un intermédiaire (Stripe Atlas)

Stripe Atlas permet de créer une société américaine (LLC au Delaware) entièrement en ligne pour environ 500 USD. Vous obtenez :

• Une LLC américaine légale
• Un compte bancaire US (Mercury ou Silicon Valley Bank)
• Un compte Stripe fonctionnel rattaché à la LLC
• Un EIN (numéro fiscal américain)

Pour qui : E-commerçants qui vendent régulièrement à l’international (diaspora, services digitaux, freelances). Si votre CA international dépasse 500 000 FCFA/mois, ça vaut l’investissement.

Coûts : 500 USD (création) + frais Stripe (2,9% + 0,30 USD par transaction) + virements vers le Sénégal (Wise, environ 1%).

Option 2 : Utiliser un partenaire avec Stripe Connect

Certaines plateformes de paiement africaines utilisent Stripe en backend et vous reversent les fonds localement :

• PayDunya — accepte les cartes Visa/Mastercard internationales et reverse en FCFA sur votre compte Wave ou bancaire
• CinetPay — même principe, avec support de Stripe comme processeur de cartes
• Flutterwave — basé au Nigeria, accepte Stripe et propose des reversements en FCFA

Avantage : Pas besoin de créer de structure étrangère. Inconvénient : Frais plus élevés (4-5% au total) et délais de reversement (2-5 jours).

Option 3 : Un proche dans un pays supporté

Si vous avez un associé, un ami ou un membre de la famille en France, Belgique, ou au Canada, il peut créer un compte Stripe et vous ajouter comme collaborateur. Les fonds arrivent sur son compte bancaire, puis il vous fait un virement (Wise, Wave International).

Attention : Cette méthode est fragile juridiquement. Formalisez l’accord avec un contrat écrit, même informel. Stripe peut fermer un compte s’il suspecte que le titulaire n’est pas le véritable vendeur.

Configurer Stripe sur WooCommerce

Une fois votre compte Stripe actif (quelle que soit la méthode), voici comment l’intégrer à votre boutique :

Étape 1 : Installer le plugin officiel

1. Dans WordPress : Extensions → Ajouter
2. Recherchez « WooCommerce Stripe Payment Gateway » (par WooCommerce, le plugin officiel)
3. Installez et activez

Étape 2 : Récupérer vos clés API

1. Connectez-vous sur dashboard.stripe.com
2. Allez dans Développeurs → Clés API
3. Copiez la Clé publiable (pk_live_…)
4. Copiez la Clé secrète (sk_live_…)

Important : Commencez en mode TEST (clés pk_test_ et sk_test_) pour vérifier que tout fonctionne avant de passer en production.

Étape 3 : Configurer le plugin

Allez dans WooCommerce → Réglages → Paiements → Stripe :

• Activer Stripe : Oui
• Titre : « Carte bancaire (Visa, Mastercard) »
• Description : « Paiement sécurisé par carte bancaire internationale »
• Mode test : Activé (pour commencer)
• Clé publiable test : pk_test_xxx
• Clé secrète test : sk_test_xxx
• Formulaire de paiement : « Éléments de paiement Stripe » (moderne et responsive)
• Capture automatique : Oui

Étape 4 : Configurer les webhooks

Les webhooks permettent à Stripe de notifier votre site quand un paiement est confirmé :

1. Dans Stripe Dashboard : Développeurs → Webhooks
2. Cliquez Ajouter un endpoint
3. URL : https://votresite.com/?wc-api=wc_stripe
4. Événements à écouter : payment_intent.succeeded, payment_intent.payment_failed, charge.refunded
5. Copiez le Secret de signature (whsec_…)
6. Collez-le dans les réglages Stripe de WooCommerce

Gérer les devises : vendre en FCFA et encaisser en EUR/USD

Votre site affiche les prix en FCFA mais Stripe travaille en EUR ou USD. Voici comment gérer ça :

Solution 1 : Plugin WOOCS (WooCommerce Currency Switcher)

• Affichez les prix dans plusieurs devises (FCFA, EUR, USD)
• Le client choisit sa devise préférée
• Stripe reçoit le paiement dans la devise sélectionnée
• Taux de change mis à jour automatiquement

Solution 2 : Prix fixe en EUR avec affichage FCFA

Fixez vos prix en EUR dans WooCommerce et utilisez un plugin pour afficher l’équivalent FCFA informatif :

// Afficher le prix en FCFA à côté du prix EUR
add_filter('woocommerce_get_price_html', 'itsc_prix_fcfa', 10, 2);
function itsc_prix_fcfa($price_html, $product) {
    $taux = 655.957; // Taux fixe EUR/XOF
    $prix_eur = floatval($product->get_price());
    $prix_fcfa = round($prix_eur * $taux, -2); // Arrondi à la centaine
    $formatted = number_format($prix_fcfa, 0, ',', ' ');
    return $price_html . '<br><small style="color:#666;">≈ ' . $formatted . ' FCFA</small>';
}

Sécuriser les paiements Stripe

3D Secure (SCA)

Stripe active automatiquement le 3D Secure quand la banque du client le demande. C’est une vérification supplémentaire (code SMS, empreinte digitale) qui protège contre la fraude.

Dans les réglages Stripe de WooCommerce, assurez-vous que « Demander l’authentification 3D Secure quand recommandé » est activé.

Radar — l’anti-fraude de Stripe

Stripe Radar est inclus gratuitement et bloque automatiquement les transactions suspectes. Pour un e-commerçant sénégalais vendant à la diaspora, quelques règles utiles dans le Dashboard Stripe :

• Bloquer les cartes de certains pays à risque (si vous ne vendez qu’en Afrique/Europe)
• Exiger le code CVC pour toutes les transactions
• Activer la vérification de l’adresse (AVS) pour les commandes > 50 EUR

Protéger vos clés API

// Dans wp-config.php (JAMAIS dans functions.php)
define('STRIPE_SECRET_KEY', 'sk_live_votre_cle_ici');
define('STRIPE_PUBLISHABLE_KEY', 'pk_live_votre_cle_ici');
define('STRIPE_WEBHOOK_SECRET', 'whsec_votre_secret_ici');

Stripe vs alternatives africaines — comparaison

Recommandation : Utilisez PayDunya ou CinetPay pour les paiements locaux (Wave, Orange Money, cartes locales). Ajoutez Stripe uniquement si vous avez un volume significatif de clients internationaux qui paient par carte.

Tester avant de passer en production

Cartes de test Stripe

Date d’expiration : n’importe quelle date future. CVC : n’importe quels 3 chiffres.

Checklist de mise en production

• ☐ Tester un achat complet en mode test
• ☐ Vérifier que la commande WooCommerce passe bien en « En cours »
• ☐ Tester un remboursement depuis le Dashboard Stripe
• ☐ Remplacer les clés test par les clés live
• ☐ Désactiver le mode test dans les réglages WooCommerce
• ☐ Faire un vrai achat de test (petit montant) en production
• ☐ Vérifier les emails de confirmation (client + admin)
• ☐ Configurer les alertes Stripe (paiements échoués, litiges)