# Installer et configurer l'application Stripe pour Shopware 6

Découvrez comment installer et configurer l'application Stripe pour Shopware 6.

Utilisez l’application Stripe pour [Shopware 6](https://www.shopware.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 [Shopware 6](https://www.shopware.com/en/), vous devez installer et configurer l’application Stripe.

## Installation du connecteur

1. Dans le backoffice Shopware, allez dans **Extensions** > **My extensions** > **Compte Shopware**, renseignez vos identifiants et cliquez sur **Login**.

1. Allez dans **Extensions** > **Store**, et dans la barre de recherche saisissez « Stripe ».

1. Cliquez sur **Stripe** > **Ajouter une extension** > **Ajouter une extension gratuitement**.

1. Cliquez sur **Install extension**.

Une fois l’installation terminée, Stripe est disponible dans **My extensions**. Testez l’application avant de la déployer en production, car votre environnement peut différer de celui des autres utilisateurs.

> Ne dupliquez pas votre boutique de production pour l’utiliser comme environnement de simulation. Cela peut corrompre les données associées à la boutique d’origine, en raison de l’infrastructure de l’application Shopware.

### Ajouter Stripe comme moyen de paiement

Quand l’installation est terminée, vous pouvez visualiser l’application sur la page des extensions dans le panneau d’administration de Shopware.

1. Dans la barre latérale du panneau d’administration, sous **Canaux de vente**, sélectionnez votre [canal de vente](https://docs.shopware.com/en/shopware-6-en/settings/saleschannel) pour ajouter Stripe comme moyen de paiement.

1. Sous **Payment and shipping**, sélectionnez **Pay with Stripe** dans le menu déroulant **Payment methods**.

1. (Facultatif) Pour afficher Stripe en premier lors du règlement, sélectionnez **Payer avec Stripe** dans le menu déroulant **Moyen de paiement par défaut**.

1. Cliquez sur **Enregistrer**.

### Mettre à jour l’application

Utilisez le panneau d’administration Shopware pour mettre à jour l’application lorsqu’une nouvelle version est disponible. Sous **Extensions**, sélectionnez **My extensions**. Pour lancer le processus de mise à jour, sélectionnez **Upgrade** dans l’onglet **Apps** de l’application Stripe.

## Configurer l’application

Utilisez le panneau d’administration de Shopware pour configurer l’application :

1. Dans la barre latérale du panneau d’administration, dans **Extensions**, sélectionnez **My extensions**.

1. Dans l’onglet **Applications**, pour l’application Stripe, cliquez sur le menu déroulant (⋯) et sélectionnez **Ouvrir l’extension**.

1. Configurez l’application Stripe pour Shopware 6 :

   - [Se connecter à Stripe pour accepter des paiements](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#connect-stripe)
   - [Choisir votre formulaire de paiement](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#payment-form)
   - [Personnaliser le formulaire de paiement](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#customize-payment-form)
   - [Collecter le code postal de votre client](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#postal-code)
   - [Choisir comment capturer les fonds](https://docs.stripe.com/use-stripe-apps/shopware6/configuration.md#capture-funds)

## Se connecter à Stripe pour accepter les paiements

Connectez Shopware à votre compte Stripe pour commencer à accepter les paiements. Lorsque vous vous connectez à un nouveau compte, vous devez réactiver vos moyens de paiement préférés.

1. Sur la page de **configuration de Stripe**, cliquez sur **Se connecter avec Stripe en mode production**. Si vous souhaitez tester différentes fonctionnalités de l’application sans traiter les paiements en mode production, utilisez **Se connecter avec Stripe en mode test**.

1. Communiquez les informations de votre entreprise pour [créer votre compte Stripe](https://dashboard.stripe.com/register).

1. Une fois votre compte Stripe créé, connectez-vous à votre [Dashboard Stripe](https://dashboard.stripe.com/).

1. Dans le Dashboard Stripe :

   - Sous **Paramètres** > **Payment methods**, sélectionnez votre compte Shopware dans le menu déroulant **Sélectionnez votre plateforme**.

   - Activez vos moyens de paiement préférés individuellement ou à l’aide du bouton **Tout activer**.

Les moyens de paiement que vous choisissez pour votre application Shopware sont distincts des [moyens de paiement de votre compte Stripe](https://docs.stripe.com/payments/payment-methods/integration-options.md).

## Connecter plusieurs canaux

Vous pouvez utiliser des comptes Stripe distincts pour vous connecter à différents canaux de vente.

- Pour chaque canal, l’onglet **Canaux de vente** de la page de configuration de Stripe affiche :

  - un bouton **Se connecter à Stripe en mode test**
  - un bouton **Se connecter à Stripe en mode production**
  - le nom et l’identifiant du compte Stripe correspondant.

- Votre compte principal est connecté par défaut. Décochez la case **Utiliser le compte par défaut** et cliquez sur **Se connecter avec Stripe […]** pour préciser le compte Stripe pour chaque canal de vente.

## 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é** : Le [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

Vous pouvez configurer l’apparence du formulaire de paiements intégré de la manière suivante :

- Choisissez un thème prédéfini : **Stripe**, **Nuit**, **Plat** ou **Aucun**.
- Positionnez le formulaire de paiement : **Au-dessus des moyens de paiement Shopware**, **En dessous des moyens de paiement Shopware** ou **Avec les moyens de paiement Shopware**.
- Utilisez l’[API Elements Appearance](https://docs.stripe.com/elements/appearance-api.md) pour personnaliser certains aspects du formulaire de paiement en modifiant `Resources/app/storefront/src/StripePaymentsApp/stripe.appearance.js` dans votre projet local.

Vous pouvez personnaliser l’apparence de Checkout à partir du [Dashboard](https://docs.stripe.com/payments/checkout/customization.md).

## 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.

- **Autorisation et capture simultanées** : La banque émettrice confirme que le titulaire de la carte est en mesure de payer, puis transfère les fonds automatiquement.

- **Autorisation et capture distinctes** : l’autorisation se produit avant la capture. Pour capturer des fonds, faites passer le statut de paiement de la commande de `Authorized` à `Paid` ou `Partially paid` dans le panneau d’administration de Shopware.

## See also

- [Présentation](https://docs.stripe.com/use-stripe-apps/shopware6.md)