Paiement express avec Stripe : configuration, mise en place, vérification

1. Bouton : dans le panier, le client choisit un mode de paiement, par exemple Apple Pay ou Google Pay.
2. Portefeuille : dans la fenêtre de paiement, il sélectionne l'adresse de livraison et le mode d'expédition. La boutique calcule alors les frais de port et le montant total.
3. Vérification : une fois le paiement effectué, la boutique vérifie auprès de Stripe si le montant a bien été reçu.
4. Commande : ce n’est qu’à ce moment-là que la boutique enregistre la commande. Si le client ne revient pas après le paiement, la boutique l’enregistre elle-même ultérieurement.

Dans la boutique

1. Ouvrez le module : sous Paramètres → Paiement → Modes de paiement, modifiez le module « Stripe ».
2. Activer : activez « Paiement via Stripe » et saisissez la « Clé publique » ainsi que la « Clé secrète » de votre compte Stripe.
3. Sélectionner les modes de paiement : le tableau « Modes de paiement », accompagné de la mention « Sélectionnez ici les modes de paiement que vous souhaitez proposer via Stripe », permet de définir lesquels, parmi les cinq modes de paiement présentés dans l’aperçu ci-dessous, peuvent s’afficher sous le bouton « Express ». Ce même tableau détermine également les modes de paiement Stripe disponibles dans le processus de commande standard. Il est possible d’ajouter plusieurs lignes, par exemple « Cartes de crédit, Apple Pay, Google Pay » et « PayPal ».
4. Autoriser l’achat express : l’option « Autoriser Stripe Checkout (achat express) » reste activée par défaut. Si elle est désactivée, aucun bouton n’apparaît à aucun des trois emplacements.
5. Activer les modes de livraison : dans l’onglet « Livraison et paiement » du module Stripe, activez les modes de livraison que le Wallet doit proposer, ainsi que l’option « Livraison gratuite », même si vous ne proposez pas ce mode de livraison. Si l’option « Livraison gratuite » ou le mode de livraison sélectionné dans le panier (le moins cher par défaut) n’est pas activé, aucun bouton n’apparaîtra. Ne validez pas les modes de livraison sous « Les frais de port sont calculés a posteriori (modules d’expédition) » (Paramètres → Paiement → Expédition/Emballage) pour Stripe : dans ce cas, le Wallet encaisserait le montant hors frais de port.
6. Enregistrer : lors de l’enregistrement, la boutique crée ou complète son point de terminaison de webhook chez Stripe. Grâce au webhook, elle est informée des paiements, même si le client ne revient pas sur la boutique.

Avec Stripe

• Enregistrer un domaine : dans le tableau de bord Stripe, enregistrez chaque domaine sur lequel apparaissent les boutons, y compris les sous-domaines tels que www, ainsi que dans le mode test pour les essais. C’est obligatoire pour Apple Pay. Stripe prévoit également l’enregistrement pour Google Pay, Link, PayPal et Amazon Pay. L’enregistrement s’effectue sur la page « Domaines des modes de paiement » (guide de Stripe). La boutique ne dispose pas de fonctionnalité dédiée à cet effet.
• Activer les modes de paiement : les boutons affichés par Stripe dépendent également des modes de paiement actifs dans votre compte Stripe. Vous devez d’abord en activer certains dans votre compte.
• Klarna : le tableau « Modes de paiement » ne contrôle pas l’affichage de Klarna dans le bouton Express. Si Klarna est actif dans votre compte Stripe, Stripe peut l’afficher en plus à cet endroit. La commande ne sera alors probablement validée qu’après la validation, comme c’est le cas avec PayPal.
• Appareil du client : un bouton « Wallet » n’apparaît que si le navigateur, l’appareil et la devise prennent en charge ce mode de paiement et si le client l’a configuré. Par exemple, si Google Pay n’est pas configuré, Stripe n’affiche pas de bouton Google Pay.

Message à la place du bouton

Avec le parcours Express, le client saute les étapes du parcours de commande normal, y compris le récapitulatif de la commande et ses conditions d’acceptation. Dans le panier hors canevas, sur la page du panier et sur la page de connexion, une remarque apparaît donc à la place du bouton Stripe. à partir de 4.10.0

Le client passe alors sa commande via la procédure habituelle. Ces six raisons déclenchent l’affichage de cette mention :

• Raison sans objet : si le client se connecte avec son compte client, le message « Téléchargement sans compte » disparaît. S’il télécharge le fichier obligatoire, le message « Téléchargement de fichier » disparaît. Le bouton réapparaît dès qu’il n’y a plus de raison justifiant son affichage.
• Produit personnalisé : cela ne déclenche pas l’affichage de la mention.
• Vérification dans la boutique : la boutique prend sa décision avant de savoir quels portefeuilles l’appareil propose. La mention apparaît donc même lorsque l’appareil ne proposerait aucun portefeuille.
• Panier modifié a posteriori : si le panier doit faire l’objet d’une vérification après le chargement du bouton, la boutique refuse le paiement avant le prélèvement et affiche la mention en haut de la page du panier.
• Autres boutons express : Amazon Pay et PayPal Checkout sont conservés, car ils renvoient à la page récapitulative de la commande.

Bouton manquant sans message

Dans ces cas, l’emplacement du bouton Stripe reste vide :

• Module : « Paiement via Stripe » est désactivé, aucune « clé publique » n’est saisie, ou « Autoriser Stripe Checkout (achat express) » est désactivé.
• Livraison et paiement : Stripe n’est pas autorisé pour la « livraison gratuite » ou pour le mode de livraison sélectionné dans le panier (sinon, c’est le mode le moins cher qui est retenu).
• Mode de paiement non autorisé : Stripe n’est pas autorisé comme mode de paiement pour le groupe de clients ou le client concerné.
• Montant minimum de commande : le « montant minimum de commande » sous Paramètres → Général → Valeurs minimales n’est pas atteint.
• Stock : l’option « Vérifier le stock » sous Paramètres → Paiement → Stock est activée, et un article n’est pas disponible.
• Caractéristiques : une combinaison de caractéristiques dans le panier ne peut pas être commandée.
• Montant : le montant total du panier est égal à 0.
• Appareil : Stripe ne propose aucun des modes de paiement autorisés sur cet appareil.

Si les deux options sont activées, elle se lit comme suit :

Les éléments mentionnés dépendent des deux boutons situés sous Paramètres → Paiement → Général. La phrase relative à l’obligation de paiement et le lien vers la déclaration de protection des données y figurent toujours.

Où mènent les liens

• CGV : vers le « fichier PDF des CGV alternatives » s’il se trouve dans le dossier « files/ », sinon vers la page CMS des CGV, par défaut « Conditions générales de vente ».
• Informations sur le droit de rétractation : vers le « fichier PDF alternatif sur le droit de rétractation », sinon vers la page CMS « Droit de rétractation ».
• Déclaration de protection des données : toujours vers la page CMS « Protection des données ».

Il s’agit des mêmes destinations que dans l’aperçu de la commande, et tous les liens s’ouvrent dans un nouvel onglet. Vous configurez les deux fichiers PDF sous Paramètres → Général → Paramètres de base.

• Visibilité : la mention légale n’apparaît que lorsque Stripe propose au moins un mode de paiement sur l’appareil. Elle est absente lorsque la mention relative à l’obligation de vérification remplace le bouton.
• TEXT_EXPRESS_CHECKOUT_LEGAL_HINT _TERMS _WITHDRAWAL _PRIVACYLesespaces réservés %1$s ( C GV), %2$s (Politique de rétractation) et %3$s (déclaration de protection des données) correspondent aux liens et doivent être conservés. Vérifiez les mentions légales après chaque modification en cliquant sur le bouton : s’il manque un espace réservé, le lien correspondant est absent, et des espaces réservés intervertis renvoient vers les mauvaises pages. Écrivez le signe « % » sous la forme « %% » ; un simple « % » peut masquer ou fausser les mentions légales.

• Compte client au lieu d’un compte invité : si l’option « Inscription obligatoire lors du processus de commande » est activée dans Paramètres → Paiement → Détails client sur always_account ou always_account_and_guest_checkbox, Express crée un compte client et envoie les identifiants par e-mail. Cela ne s’applique que si aucun compte client n’existe encore pour cette adresse e-mail.
• Numéro de téléphone : le Wallet ne le demande que si l’option « Numéro de téléphone » est cochée dans Paramètres → Paiement → Détails du client sur mandatory.

• Modes de livraison : si le client sélectionne une adresse dans le Wallet, la boutique calcule ses modes de livraison. Si le client n’est pas connecté, le calcul s’effectue à partir du code postal, de la ville et du pays de cette adresse ; pour les clients connectés, il s’effectue à partir de l’adresse de livraison figurant dans le compte client. Seuls les modes de livraison pour lesquels Stripe est activé sous « Livraison et paiement » sont proposés ; le Wallet affiche leur nom et leur prix.
• Présélection : le mode de livraison présélectionné est celui du panier ; à défaut, c’est le premier dans l’ordre de vos modules d’expédition.
• Montant : la boutique effectue le calcul comme lors de la commande, en tenant compte des frais de livraison, des suppléments, des remises, des frais et des taxes. Elle recalcule le montant à chaque changement de mode de livraison.
• Aucun mode de livraison adapté : s’il n’existe aucun mode de livraison pour l’adresse ou si le montant total ne peut être calculé, le Wallet rejette l’adresse. Le message correspondant provient du Wallet, et non de la boutique.

Vérification après la commande

Après la création de la commande, la boutique compare le montant prélevé avec la commande. Si le paiement ne couvre pas la commande, celle-ci reçoit le statut « Statut de la commande (paiement asynchrone) » ou, en l’absence de ce paramètre, son statut par défaut au lieu du statut « Statut de la commande (paiement immédiat) », accompagné d’une note interne.

Si le montant diffère de plus de 1 centime ou si la commande ne contient aucun article, la boutique vous envoie en outre un e-mail, voir « E-mail de l'exploitant ». 4.10.0

Retrait (Click & Collect)

• Sélection de la boutique : si, dans le module « Click & Collect », la « Sélection de la boutique » est réglée sur « required », le Wallet ne propose pas l’enlèvement tant que le client n’a pas préalablement sélectionné une boutique dans la boutique en ligne. à partir de 4.10.0
• Modes de paiement de la boutique : si une boutique dispose de ses propres modes de paiement sans Stripe, le retrait via le Wallet n’est pas non plus disponible.

Vous pouvez configurer les modes de livraison dans Paramètres → Paiement → Modes de livraison; pour en savoir plus, consultez le guide « Expédition et livraison ».

Le statut du paiement est incertain dans les cas suivants :

• Stripe signale que le paiement est en cours de traitement ou simplement réservé.
• Il n’est actuellement pas possible de vérifier ce statut, par exemple en cas de panne réseau ou de dysfonctionnement chez Stripe.
• La finalisation de la commande est interrompue alors que l'argent a déjà été débité.
• L'argent a été transféré sans qu'une commande n'ait été créée, par exemple après une redirection vers PayPal ou Amazon Pay, ou lorsque l'onglet a été fermé.

Ce que voit le client

Après une interruption dans la fenêtre de paiement, le client est redirigé vers la page du panier. L'un des messages suivants s'affiche en haut de la page :

Après avoir été redirigé vers PayPal ou Amazon Pay, le client ne revient pas sur la page du panier. Les clients connectés voient le message correspondant sur la page « Informations de paiement », tandis que les visiteurs non connectés sont redirigés vers la page de connexion sans message. Le message s'affiche pour eux dès qu'ils tentent à nouveau de payer avec Stripe.

Fonctionnement du blocage

• Pas de deuxième paiement via Stripe : la boutique refuse toute nouvelle tentative de paiement express avant le prélèvement. Le processus de commande normal via Stripe ne mène pas à la page de paiement de Stripe, mais renvoie vers le panier avec ce message.
• Paiement validé : si un paiement « Express » a été effectué et validé, mais n’a pas encore été comptabilisé, une nouvelle tentative mène directement à la finalisation de la commande au lieu d’un deuxième paiement.
• Fin du blocage : le blocage prend fin lorsque Stripe signale que le paiement n’a pas été effectué, lorsqu’il existe une commande associée à ce paiement ou au plus tard après 24 heures.
• Portée : le blocage s’applique à Stripe pendant la session du client. Il ne bloque pas les autres modes de paiement ni les autres appareils.

1. Notification : Stripe signale un paiement réussi pour lequel la boutique ne dispose d’aucune commande. La boutique enregistre cette notification.
2. Délai d’attente : la commande est créée au plus tôt après le délai indiqué dans « Restauration de la commande – Délai (minutes) ». La valeur par défaut est de 30 minutes, mais une plage de 5 à 180 minutes est autorisée. Ce délai d’attente empêche la création d’une double commande si le client revient immédiatement.
3. Déclencheur : la boutique traite les notifications enregistrées dès la réception du prochain webhook de Stripe. En période creuse, cela peut donc prendre nettement plus de temps que le délai d’attente défini.
4. Commande : elle repose sur l’instantané du panier. Lors du paiement, la boutique y enregistre le contenu et les montants du panier.

Une confirmation de paiement ultérieure de Stripe ne fait passer une commande Stripe au statut « Statut de la commande (payée immédiatement) » que si Stripe confirme le prélèvement et que le montant couvre la somme comptabilisée. Une commande non couverte conserve son statut.

Ce que vous voyez dans la commande

• Remarque interne : chaque commande restaurée comporte une note dans l’historique, invisible pour le client. Elle commence par « „Diese Bestellung wurde automatisch vom XONIC Shopsystem restauriert“ » et vous invite à vérifier l’exactitude de la commande et l’absence de doublons avant d’envoyer une confirmation de commande au client.
• Pas de confirmation de commande : la restauration n’envoie pas de confirmation de commande au client ; celui-ci n’a donc encore rien reçu de la boutique. Après vérification, vous devez l’envoyer vous-même dans les plus brefs délais.

Ce que vous devez faire

1. Vérification : pour les commandes comportant la mention « Montant », « Article », « Remboursement » et « Contestation », comparez-les avec le paiement dans le tableau de bord Stripe.
2. Vérification des doublons : s’il existe déjà une commande normale correspondant au même panier, vérifiez dans le tableau de bord Stripe si deux paiements ont été reçus. Ce n’est que dans ce cas que la commande restaurée constitue un doublon. Attribuez-lui le statut « Annulé » ; si l’option « Rétrofacturation automatique » est activée dans le module Stripe, la boutique remboursera alors votre paiement.
3. Compléter : ajoutez les articles manquants dans l’éditeur de commande, voir « Modifier les commandes ».
4. Finaliser : Ce n’est qu’alors que vous pouvez définir le statut et envoyer la confirmation de commande : dans l’éditeur de commande, activez « Envoyer la confirmation de commande » et cliquez sur « Actualiser ».

• Ce qui est supprimé : ce paramètre permettait de choisir entre « legacy », l’ancien bouton « Payment Request » de Stripe, et « new », l’élément Express Checkout.
• Ce que fait la mise à jour : elle définit automatiquement le paramètre sur new, même lorsque certains domaines du Multishop ont leur propre valeur. Vous n’avez rien à modifier au niveau du paramètre lui-même.
• Boutiques utilisant legacy: après la mise à jour, elles afficheront l’élément « Express Checkout », tout comme les anciennes installations ne disposant pas de ce paramètre. En fonction de la sélection effectuée dans le module Stripe, Link, PayPal et Amazon Pay s’afficheront également aux côtés d’Apple Pay et de Google Pay.
• PayPal et Amazon Pay : si votre boutique fonctionnait avec legacy et qu’une ligne indiquant « PayPal », « Amazon Pay » ou « Tous les modes de paiement » (par exemple pour la page de paiement de Stripe) figure dans le tableau « Modes de paiement », ces modes de paiement apparaîtront pour la première fois dans le bouton Express après la mise à jour. Il n’existe pas de sélection spécifique réservée au bouton « Express ». Testez ces modes de paiement après la mise à jour ; voir la section « Pièges à éviter ».
• Modèles personnalisés : aucune modification n’est nécessaire.