# Installer l’application Stripe pour la gestion des commandes Salesforce Installez et configurez l’application Stripe. ## Avant d’installer l’application de gestion des commandes Salesforce 1. Dans votre instance Salesforce, identifiez l’organisation et la boutique B2C Commerce dans laquelle vous souhaitez installer et mapper l’application. 1. Examinez les droits et les [prérequis](https://docs.stripe.com/use-stripe-apps/salesforce-order-management.md) avant de démarrer le processus d’installation. 1. Veuillez prendre note des limites de l’intégration : 1. Prend uniquement en charge une seule vitrine B2C 1. Prend uniquement en charge la capture manuelle ponctuelle 1. Ne prend pas en charge les scénarios complexes tels que la surcapture et la multicapture ## Installation Pour en savoir plus sur l’intégration de Salesforce Order Management, contactez-nous via le formulaire du [service de support Stripe](https://support.stripe.com). Vérifiez que **Installer pour les administrateurs uniquement** est sélectionné et cliquez sur **Installer**. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-install.a95bc450897ae2c8fec49837590ce099.png) Approuvez l’accès depuis et vers des sites Web tiers. Cochez la case « Grant Access » et cliquez sur **Continue**. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-3p-access.fea0d91a0e164d00b01c288cbe51475e.png) Si l’installation prend du temps, vous recevrez un e-mail vous informant que le package est installé. Pour vérifier l’installation, accédez à **Setup > Apps > Packaging > Installed Packages** et assurez-vous que le package est installé. ## Configuration Les instructions des sections suivantes expliquent en détail comment configurer votre intégration. ### Configurer un adaptateur de passerelle de paiement synchrone Stripe 1. Suivez les instructions de l’étape 3 de la procédure de [configuration d’un adaptateur de passerelle de paiement synchrone dans Salesforce](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_sync_adapter_setup.htm) pour créer un fournisseur de passerelles de paiement. Voici l’ensemble des valeurs que nous recommandons pour la charge utile : ```json { "ApexAdapterId": "Output of this Query: SELECT Id FROM ApexClass WHERE Name IN ('StripeAdapter')", "DeveloperName": "StripeProvider", "MasterLabel": " StripeProvider", "IdempotencySupported": "No", "Comments": "Stripe Synchronous Payment Gateway Adapter" } ``` 1. Réalisez l’étape 3 de la procédure d’[installation d’adaptateur de passerelle de paiement synchrone dans Salesforce](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_sync_adapter_setup.htm) afin de créer un enregistrement de passerelle de paiement. Valeurs recommandées : | Libellé du champ | Valeur | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nom | SALESFORCE_PAYMENTS | | Merchant Credential ID | Résultat de cette requête : `SELECT Id FROM NamedCredential WHERE DeveloperName = 'StripeAPI'` | | Fournisseur de passerelle de paiement | Résultat de la requête (modifiez la requête en conséquence si votre fournisseur de passerelle de paiement synchrone Stripe est différent de ‘StripeProvider’) : `SELECT Id FROM PaymentGatewayProvider WHERE DeveloperName ='StripeProvider'` | | État | Active | ### Configurer un adaptateur de passerelle de paiement asynchrone Stripe 1. Suivez les instructions de [configuration d’adaptateur de passerelle de paiement asynchrone dans Salesforce](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_async_adapter_setup.htm) afin de configurer l’adaptateur de passerelle de paiement asynchrone de Stripe (ignorez les étapes 2 et 3 si vous avez déjà configuré l’adaptateur de passerelle de paiement synchrone de Stripe). Pour créer un fournisseur de passerelles de paiement asynchrone, suivez l’étape 4 de ces instructions. Voici l’ensemble de valeurs recommandé pour la charge utile : ```json { "ApexAdapterId": "Output of this Query: SELECT Id FROM ApexClass WHERE Name IN (‘StripeAsyncAdapter’)", "DeveloperName": "StripeAsyncAdapter", "MasterLabel": " StripeAsyncAdapterProvider ", "IdempotencySupported": "No", "Comments": "Stripe Asynchronous Payment Gateway Adapter" } ``` 1. Réalisez l’étape 5 (Créer un enregistrement de passerelle de paiement) de la procédure de [configuration d’adaptateur de passerelle de paiement asynchrone dans Salesforce](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_commercepayments_async_adapter_setup.htm) afin de stocker l’enregistrement de la passerelle de paiement asynchrone Stripe dans Salesforce. Voici les valeurs recommandées pour les champs à renseigner (si vous créez un enregistrement de passerelle pour la première fois) ou à mettre à jour (si vous avez déjà créé un enregistrement de passerelle lors de la configuration de l’adaptateur de passerelle de paiement synchrone). | Libellé du champ | Valeur | | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Nom | SALESFORCE_PAYMENTS | | Merchant Credential ID | Résultat de cette requête : `SELECT Id FROM NamedCredential WHERE DeveloperName = 'StripeAPI'` | | Fournisseur de passerelle de paiement | Résultat de la requête (modifiez la requête en conséquence si votre fournisseur de passerelle de paiement synchrone Stripe est différent de ‘StripeProvider’) : `SELECT Id FROM PaymentGatewayProvider WHERE DeveloperName ='StripeAsyncAdapter'.` | | État | Active | 1. Suivez les instructions de l’étape 6 pour configurer l’URL de webhook pour Stripe, typiquement une URL HTTPS publique. Par exemple : https://mydomainname.my.salesforce-sites.com/subdomain/services/data/v[Replace_ME_version]/commerce/payments/notify%20?provider= ```sql SELECT Id FROM PaymentGatewayProvider WHERE DeveloperName = ‘StripeAsyncAdapter’ ``` [Replace_ME_version] par la version d’API de votre organisation, 49.0 ou ultérieure. 1. Suivez les étapes ci-dessous pour enregistrer l’URL de vos webhooks dans Stripe : 1. Connectez-vous au [Dashboard Stripe](https://dashboard.stripe.com/dashboard). 1. Accédez à l’onglet [Webhooks](https://dashboard.stripe.com/webhooks) dans Workbench. 1. Cliquez sur **Créer un endpoint**. 1. Ajoutez les types d’événements suivants : `charge.refunded`, `charge.succeeded`, `charge.captured`, puis cliquez sur **Continuer**. 1. Saisissez l’URL de vos webhooks, puis cliquez sur **Créer une destination**. 1. Copiez votre clé secrète de signature de webhook et enregistrez-la en vue d’une utilisation ultérieure.![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-stripe-copy-wh-secret.6520c64215f84d4053a8bf9c927d8796.png) ## Finalisez la configuration à l’aide de Stripe OM Setup Les instructions des sections suivantes expliquent en détail comment finaliser la configuration de votre intégration. ### Autoriser l’application Stripe OMS avec votre compte Stripe Dans votre organisation Salesforce Order Management, utilisez l’assistant de configuration Stripe pour connecter votre organisation à votre compte Stripe. 1. Ouvrez l’App Launcher, puis cliquez sur **View All**. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-launch-app-launcher.abb6c08a1cde704115918ebaddfe3ff4.png) 1. Cliquez sur **Stripe OM Setup**. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-launch-om-setup.d84d6c532e02356ab40073b2bec20f14.png) 1. Cliquez sur **Get Started**. 1. Basculez en mode production. Nous vous recommandons dans un premier temps de rester en mode test pour tester votre intégration Stripe sans affecter vos données de production, et de n’activer le mode production qu’une fois prêts à traiter des transactions réelles avec la passerelle de paiement Stripe. Revenez à cette étape et autorisez à nouveau votre connexion pour basculer entre le mode test et le mode production. Si vous êtes en mode production et que vous souhaitez revenir en mode test, vous n’avez pas besoin de renouveler l’autorisation. 1. Cliquez sur **Authorize**. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-authorize.d4883cff2b90cce49e6054a05daa9079.png) Cela permet à Salesforce d’accéder à vos données Stripe afin que vous puissiez capturer et rembourser les paiements. Le site web de Stripe s’ouvre pour finaliser le processus d’autorisation, qui peut nécessiter la saisie d’informations de connexion ou la configuration de votre compte Stripe. Le site vous redirige ensuite vers cette page pour terminer le processus de configuration. Une fois la procédure d’autorisation terminée, le message suivant s’affiche : ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-authorize-complete.8ff6523255d2652a3dacaa56304c0090.png) Stockez la clé secrète de signature du webhook pour le traitement des paiements asynchrones Stripe. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-store-wh-secret.9918a70a19d3886755228a68102c1979.png) 1. Ajoutez la valeur de la clé secrète de signature du webhook dans **Signing secret**. 1. Cliquez sur **Update**. 1. Un message apparaît en haut pour confirmer l’insertion. Cliquez sur **Finish**. ### Modifier les flux de gestion des commandes existants L’authentification avec Stripe fonctionne avec OAuth, Stripe étant le fournisseur OAuth. Salesforce ne prend pas en charge Stripe en tant que fournisseur OAuth ; par conséquent, le token OAuth est obtenu via une intégration personnalisée utilisant une action invocable **getAccesToken**. Les ressources voulues sont incluses dans le paquet géré de Stripe OM Connector. Identifiez le flux qui initie le paiement ou le remboursement à Stripe et incluez la méthode invocable **getAccessToken** dans une action précédant directement l’action **Ensure Funds** dans le flux (comme illustré dans l’exemple suivant). Les flux à modifier sont différents de ceux présentés dans l’exemple suivant. 1. Accédez à **Setup > Process Automation > Flows**. 1. Sélectionnez le **Flow** (flux) actif à utiliser pour capturer les fonds. 1. Créez une nouvelle **Action** qui appelle la méthode invocable `getAccessToken`. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-generate-token.4e707e9311288fd5e7f6e93a47dc638d.png) 1. Veillez à ce que l’action **Get Access Token** intervienne avant l’action **Capture Funds**. Une fois l’opération terminée, enregistrez une nouvelle version de ce **Flow** pour vous assurer que vos processus utilisent la nouvelle version. ![](https://b.stripecdn.com/docs-statics-srv/assets/sfom-flowbuilder.22b239ea431eca499ef4cddd690ade94.png) 1. Vous pouvez désormais utiliser Stripe Payment comme moyen de paiement dans votre organisation Order Management. Vous pouvez passer des commandes à partir de Salesforce B2C Commerce Cloud et effectuer des transactions, telles que des transactions de capture et de remboursement pour les moyens de paiement associés aux paiements Salesforce Commerce. ## Étapes suivantes - [Exploitation et maintenance](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/operations-and-maintenance.md) - [Effectuer des tests](https://docs.stripe.com/use-stripe-apps/salesforce-order-management/testing.md)