Cartes, portefeuilles et moyens de paiement locaux avec un seul prestataire : intégrez Stripe à Shopware 6 via le plugin officiel ou l’API, webhooks, cartes de test et mise en production compris, pour votre boutique en France.
Que votre boutique encaisse les paiements de façon fluide et sécurisée n’est pas négociable. Ce guide accompagne les e-commerçants en France et les développeurs vers une intégration Stripe solide dans Shopware 6. Vous y verrez :
Notre panorama des intégrations de paiement pour Shopware présente les autres prestataires disponibles.
Stripe est une plateforme qui permet d’accepter des paiements en ligne : achats ponctuels, abonnements ou versements aux vendeurs d’une marketplace. Au-delà du simple paiement par carte, Stripe propose :
Pour les boutiques headless ou les processus fortement personnalisés :
stripe/stripe-php via Composer, créer des PaymentIntents, confirmer les paiements et gérer les abonnements.payment_intent.succeeded, invoice.payment_failed ou charge.refunded et mettre à jour le statut de commande dans Shopware.Nous développons ce type d’intégration sous forme de plugin ou d’app Shopware : voir développement de plugins Shopware.
Si vous gérez vos extensions avec Composer, récupérez le paquet via votre compte Shopware, puis activez-le :
bin/console plugin:refresh
bin/console plugin:install --activate StripeShopwarePayment
bin/console cache:clear
Le nom technique exact s’affiche avec bin/console plugin:list.
pk_test_ et sk_test_).payment_intent.succeeded, payment_intent.payment_failed, charge.refunded et, pour les abonnements, invoice.payment_succeeded.whsec_…) dans la configuration du plugin.De nombreuses versions du plugin créent le point de terminaison automatiquement. Vérifiez dans le Dashboard qu’il existe et pointe vers le bon mode.
Activez ensuite les moyens de paiement sous Paramètres → Boutique → Modes de paiement et affectez-les aux canaux de vente.
4242 4242 4242 4242, date d’expiration future quelconque, cryptogramme quelconque.Avec le Payment Element, Stripe affiche tous les moyens de paiement activés dans un seul formulaire, directement dans votre checkout. La structure de base d’une intégration sur mesure :
<form id="payment-form">
<div id="payment-element"></div>
<button id="submit">Payer maintenant</button>
</form>
const stripe = Stripe('pk_test_VOTRE_CLE');
// clientSecret provient du PaymentIntent créé par votre serveur
const elements = stripe.elements({ clientSecret });
const paymentElement = elements.create('payment');
paymentElement.mount('#payment-element');
document.getElementById('payment-form').addEventListener('submit', async (e) => {
e.preventDefault();
const { error } = await stripe.confirmPayment({
elements,
confirmParams: { return_url: 'https://votre-boutique.fr/checkout/finish' }
});
if (error) { console.error(error.message); }
});
Le plugin Shopware se charge lui-même de cette intégration ; ce code ne vous concerne que si vous construisez votre propre checkout.
4242 4242 4242 42424000 0000 0000 00024000 0000 0000 99954000 0025 0000 3155pk_live_, sk_live_) dans la configuration du plugin.Stripe envoie une notification à chaque événement important. Les plus fréquents :
payment_intent.succeeded : marquer la commande comme payée et envoyer la confirmation.payment_intent.payment_failed : informer le client et proposer un autre moyen de paiement.charge.refunded : passer la commande au statut « remboursée » et envoyer le justificatif.invoice.payment_succeeded : prolonger l’abonnement et envoyer le reçu.$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_STRIPE_SIGNATURE'] ?? '';
try {
$event = \Stripe\Webhook::constructEvent($payload, $signature, $webhookSecret);
} catch (\Exception $e) {
http_response_code(400);
exit;
}
switch ($event->type) {
case 'payment_intent.succeeded':
$this->markOrderPaid($event->data->object->metadata->order_id);
break;
case 'payment_intent.payment_failed':
$this->notifyCustomer($event->data->object->metadata->order_id);
break;
}
http_response_code(200);
Vérifiez toujours la signature, répondez rapidement avec un code 200 et traitez l’événement de manière idempotente, car Stripe renouvelle les envois. Pour savoir comment Shopware gère lui-même les webhooks, lisez notre article sur les webhooks dans Shopware 6.
var/log/.stripe listen --forward-to https://votre-boutique.test/stripe/webhookAvec Stripe Checkout ou Elements, c’est Stripe qui traite les données de carte, pas votre serveur. Servez les pages de checkout exclusivement en HTTPS et ne journalisez jamais de données de carte complètes.
Activez les règles standard de Radar, examinez régulièrement les paiements signalés et affinez les seuils pour les schémas suspects. Utilisez 3-D Secure : en Europe, et donc en France, l’authentification forte du client (DSP2) est de toute façon obligatoire.
Associez à chaque PaymentIntent le numéro de commande, l’ID client et le montant du panier sous forme de métadonnées. Les paiements se rapprochent ainsi sans ambiguïté entre Stripe et votre comptabilité.
Comment changer de clés API sans mettre la boutique hors ligne ?
Le plugin conserve en parallèle les clés de test et les clés live ; vous saisissez les nouvelles clés et changez de mode avec l’interrupteur. Pour une intégration sur mesure, déployez la modification à une heure de faible trafic.
Puis-je proposer le paiement en plusieurs fois ?
Oui. Activez dans le Dashboard Stripe, sous Moyens de paiement, des options « Achetez maintenant, payez plus tard » comme Klarna, puis activez-les dans le plugin. En France, des solutions comme Alma ou Oney s’intègrent via leurs propres extensions.
Comment fonctionnent les remboursements ?
Les remboursements complets se déclenchent depuis la commande Shopware, le plugin appelle l’API Stripe. Les remboursements partiels se font dans le Dashboard Stripe ou via l’API en précisant le montant.
Combien coûte Stripe ?
Pour les cartes de l’Espace économique européen, le tarif standard affiché par Stripe pour la France est de 1,5 % + 0,25 € par transaction (selon le fournisseur, page tarifs de stripe.com/fr) ; les cartes internationales et la conversion de devises coûtent davantage.
Quels moyens de paiement compléter avec Stripe ?
Pour le marché français, surtout PayPal et Amazon Pay, ainsi que le paiement en plusieurs fois. Notre analyse de boutique montre où votre checkout perd des clients ; solution25 s’adresse aux e-commerçants en France qui veulent l’optimiser.