# Installez et configurez le module Stripe pour PrestaShop

Installez et configurez le module PrestaShop depuis Stripe App Marketplace.

Utilisez le module Stripe pour [PrestaShop](https://www.prestashop.com/en) afin d’intégrer [Stripe Elements](https://docs.stripe.com/payments/elements.md) et d’accepter plus de 25 moyens de paiement avec une seule intégration. Pour utiliser Stripe avec [PrestaShop](https://www.prestashop.com/en), vous devez installer, puis configurer l’application Stripe.

## Installer le module

Installez l’application pour PrestaShop à partir de Stripe App Marketplace pour obtenir les clés secrètes et publiques nouvellement générées. Ce processus renforce la sécurité de votre plugin en simplifiant l’utilisation de clés limitées distinctes pour chaque intégration avec votre compte Stripe. Cette approche élimine la nécessité de créer manuellement votre propre clé limitée ou d’utiliser une clé secrète. Pour installer l’application et renforcer l’infrastructure de sécurité de votre compte :

1. Accédez à [Stripe App Marketplace](https://marketplace.stripe.com/), puis cliquez sur [Installer l’application PrestaShop](https://marketplace.stripe.com/apps/install/link/com.stripe.PrestaShop.commerce).

1. Sélectionnez le compte Stripe sur lequel vous souhaitez installer l’application.

1. Vérifiez et approuvez les autorisations de l’application, installez l’application dans un *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) ou en mode production, puis cliquez sur **Installer**.

1. Après avoir installé l’application, conservez les clés dans un endroit sûr où vous ne risquez pas de les perdre. Pour vous souvenir de l’endroit où vous les avez rangées, vous pouvez [laisser une note à propos des clés dans le Dashboard](https://docs.stripe.com/keys.md#reveal-an-api-secret-key-live-mode).

1. Utilisez la clé publique et la clé secrète nouvellement générées pour finaliser la configuration de l’application.

1. Pour gérer l’application ou générer de nouvelles clés de sécurité après l’installation, accédez à la page des paramètres de l’application dans un environnement de test ou en [mode production](https://dashboard.stripe.com/settings/apps/com.stripe.PrestaShop.commerce).

Vous pouvez également installer le module manuellement. [Téléchargez le fichier zip](https://addons.prestashop.com/en/payment-card-wallet/24922-stripe-official-sca-ready.html), puis téléchargez le module dans le Dashboard de PrestaShop sous **Gestionnaire de modules**.

## Mettre à jour le module

Utilisez le Dashboard de PrestaShop pour mettre à jour le module lorsqu’une nouvelle version est disponible. Sous **Modules**, sélectionnez **Gestionnaire de modules**. Dans l’onglet **Modules**, pour le module Stripe, cliquez sur **Upgrade**, puis sur **Upgrade anyway**. Une fois la mise à jour terminée, une notification s’affiche dans le tableau de bord.

## Configurer le module

Utilisez le Dashboard PrestaShop pour configurer le module :

1. Dans **Modules**, sélectionnez **Module Manager**.

1. Dans l’onglet **Modules**, pour **Module de paiement Stripe**, cliquez sur **Configurer**.

1. Configurez l’application Stripe pour PrestaShop :

   - [Se connecter à Stripe pour accepter des paiements](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#connect-stripe)
   - [Choisir votre formulaire de paiement](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#payment-form)
   - [Personnaliser le formulaire de paiement](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#customize-payment-form)
   - [Collecter le code postal de votre client](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#postal-code)
   - [Choisir comment capturer les fonds](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#capture-funds)
   - [Enregistrer les moyens de paiement des clients](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#payment-methods)
   - [Choisir le moment de la création de la commande](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#order-creation)
   - [Activez la journalisation étendue](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#extended-logging)
   - [Connectez-vous à Cloud Sync et à votre compte PrestaShop](https://docs.stripe.com/use-stripe-apps/prestashop/configuration.md#cloudsync-prestashopaccount)

## Se connecter à Stripe pour accepter les paiements

Connectez PrestaShop à votre compte Stripe pour commencer à accepter des paiements.

1. Sur la page **Stripe Configure**, cliquez sur **Connect with Stripe**.

1. Accédez à la page **Configurer Stripe** dans le Dashboard PrestaShop, puis collez la clé du module Stripe PrestaShop dans le champ approprié.

## Choisir votre formulaire de paiement

Configurez le formulaire de paiement qui s’affiche pour vos clients lors du règlement. Dans **Paramètres du formulaire de paiement**, vous avez le choix entre les options suivantes :

- **Formulaire de paiement intégré** : [Payment Element](https://docs.stripe.com/payments/payment-element.md) est un composant d’interface utilisateur intégrable qui vous permet d’accepter plus de 25 moyens de paiement avec une seule intégration.

- **Rediriger vers Stripe** : [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) vous permet de rediriger vos clients vers une page de paiement personnalisable hébergée par Stripe afin de finaliser le paiement.

## Personnaliser le formulaire de paiement

1. Cliquez sur la case d’option **Formulaire de paiement intégré** pour afficher les options de personnalisation.

1. Choisissez une [disposition](https://docs.stripe.com/payments/payment-element.md#layout) pour le **formulaire de paiement intégré** :

   - **Accordéon avec cases d’option**
   - **Accordéon sans case d’option**
   - **Onglets**

1. Choisissez l’emplacement du formulaire de paiement :

   - **Au-dessus des moyens de paiement PrestaShop**
   - **En dessous des moyens de paiement PrestaShop**
   - **Avec les moyens de paiement PrestaShop**

1. Choisissez un thème prédéfini qui s’accorde le mieux à votre site Web :

   - **Stripe**
   - **Plat**
   - **Nuit**
   - **Aucun**

Vous pouvez [également personnaliser l’apparence et le comportement de la page de paiement](https://docs.stripe.com/payments/checkout/customization.md).

## Express Checkout Element

Express Checkout Element vous permet d’afficher des boutons de paiement en un clic avec Link, Apple Pay, Google Pay et Amazon Pay. Stripe trie les boutons de paiement de manière dynamique en fonction de la localisation du client, de l’environnement détecté et d’autres facteurs de conversion optimisés.

Dans le back-office, vous pouvez personnaliser Express Checkout Element après avoir coché la case **Activer Express Checkout**.

1. Indiquez où afficher les boutons de paiement en un clic :

   - Sur la **page produit**
   - Sur la **page du panier**

1. Choisissez différents thèmes et types de boutons pour Apple Pay et Google Pay.

Les utilisateurs connectés et invités peuvent effectuer des achats en utilisant les boutons Express Checkout. Les utilisateurs invités peuvent entrer leur adresse dans l’interface de paiement.

## Collecter le code postal de votre client

Vous pouvez indiquer si vous souhaitez ou non collecter le code postal de votre client lors du règlement à l’aide du champ **Ne jamais recueillir le code postal**. Stripe recommande de collecter et vérifier le code postal, ce qui peut permettre de réduire le taux de refus de paiement par carte.

- (Recommandé) **Décochez** ce champ si vous souhaitez demander un code postal lors du règlement. Cela s’applique aux cartes émises au Canada, au Royaume-Uni ou aux États-Unis.

- **Sélectionnez** ce champ si vous ne souhaitez pas collecter le code postal lors du règlement.

## Choisir comment capturer des fonds

Vous pouvez indiquer comment vous souhaitez autoriser et capturer des fonds à l’aide du champ **Activer l’autorisation et la capture distinctes**.

- **Décochez** ce champ pour utiliser simultanément l’autorisation et la capture. La banque émettrice confirme que le titulaire de la carte est en mesure de payer, puis transfère les fonds automatiquement.

- **Cochez** ce champ pour utiliser l’autorisation et la capture séparées. L’autorisation se produit avant la capture.

Vous disposez généralement de 7 jours pour autoriser un paiement.

Pour capturer des fonds, procédez de l’une des manières suivantes :

- Dans le tableau de bord de PrestaShop, modifiez le statut de paiement de la commande de `Authorized` sur le statut spécifié dans le champ **État de capture**. Par exemple, vous pouvez utiliser `Shipped` comme état de la capture. La capture se produit automatiquement lorsque le statut est modifié.

  En cas d’échec de la capture, le statut change sur la valeur spécifiée dans le champ **Passer à l’état de commande suivant si l’autorisation expire avant qu’elle ne soit capturée**.

- Dans le Dashboard Stripe, sous **Paiements**, sélectionnez **Tous les paiements**. Dans l’onglet **Non capturé**, sélectionnez la commande puis cliquez sur **Capturer**.

## Enregistrer les moyens de paiement des clients

Vous pouvez permettre à vos clients d’enregistrer leurs informations de paiement pour régler plus rapidement leurs achats à l’aide du paramètre **Enregistrer les moyens de paiement au niveau du client** :

- **Désactivé** : Les moyens de paiement ne sont pas enregistrés.
- **En cours de session** : Au moment du paiement, les clients sont invités à indiquer s’ils souhaitent enregistrer leurs informations de paiement pour pouvoir les réutiliser.
- **Hors session**: au moment du paiement, il est demandé aux clients s’ils souhaitent enregistrer leurs informations de paiement pour une utilisation ultérieure. Ils sont également informés qu’en fournissant leurs informations de carte bancaire, ils autorisent de futurs paiements conformément à vos Conditions. Ceci est utile pour des scénarios comme les renouvellements d’abonnement, les frais de retard, les frais accessoires (par exemple les locations de voitures) ou les paiements MOTO.

## Choisir le moment de la création de la commande

Vous pouvez préciser le moment de la création de la commande au cours du processus de paiement à l’aide du champ **Flux de paiement** :

- (Recommandé) **Créer la commande après l’initiation du paiement** : crée la commande lorsque le client clique sur le bouton **Passer la commande**.
- (Ancienne méthode) **Créer la commande après la confirmation du paiement** : crée la commande après la validation du paiement par Stripe.

## Activez la journalisation étendue

Vous pouvez vérifier la **Journalisation étendue** pour capture l’activité détaillée afin de faciliter le débogage. Lorsqu’il n’est pas coché, le module enregistre uniquement les logs standards.

## Connectez-vous à Cloud Sync et à votre compte PrestaShop

PrestaShop vous recommande de connecter Stripe à **Cloud Sync** et à votre **compte PrestaShop** pour enregistrer les données de votre boutique en toute sécurité et les synchroniser avec le cloud de PrestaShop. Cela permet une gestion centralisée et un suivi des performances en temps réel.

1. Sur la page **Stripe Configure**, cliquez sur **Associer** dans la section **Associer votre magasin à un compte PrestaShop**.

1. Cliquez sur **Accepter et associer**.

1. Cliquez sur **Poursuivre l’installation**. Une coche verte et un message confirment que vous avez bien associé votre boutique au compte PrestaShop.

1. Sur la page **Configuration de Stripe**, cliquez sur **Partager mes données** dans la section **Partager vos données avec le module de paiement Stripe**

1. Cliquez sur **Autoriser**. Une coche verte et un message confirment la synchronisation des données.

Sur Prestashop 1.7 avec **multishop** activé et l’option **Tous les magasins** sélectionnée, la boîte d’affichage des dépendances peut persister. Pour continuer, cliquez sur **Passer** ou sélectionnez une boutique spécifique pour accéder à la configuration de l’application.

## Remboursements

Pour rembourser un paiement, vous avez besoin de l’ID de paiement Stripe de la commande.

1. Dans le tableau de bord de PrestaShop, sous **Orders**, sélectionnez **Orders**.

1. Trouvez la commande que vous souhaitez rembourser, puis copiez l’**ID de paiement** dans **Stripe**.

1. Pour initier un remboursement intégral ou partiel, procédez comme suit :

   1. Accédez à l’onglet **Remboursement** dans **Module de paiement Stripe**.

   1. Dans le champ **ID de paiement Stripe**, copiez l’ID de paiement.

   1. Sélectionnez **Remboursement total** ou **Remboursement partiel**. Si vous souhaitez initier un remboursement partiel, vous devez indiquer le montant à rembourser.

   1. Cliquez sur **Demander un remboursement**.

## Élément de message sur les moyens de paiement

L’**élément de message sur les moyens de paiement** est un composant d’interface utilisateur dynamique qui informe les clients des options **Acheter maintenant, payer plus tard (paiement différé)** disponibles avant leur paiement.

- **Fonctionnalité :** Affiche automatiquement les offres en fonction de la localisation, la devise et le total spécifique de commande du client.
- **Placement :** affiché sur la **page produit** et la **page du panier**.
- **Design :** Hérite automatiquement du thème de votre site pour un affichage et une sensation fluides.