Comment intégrer Stripe

Dans le Back Office de B2CORE, accédez à Système > Connexions externes.

Cliquez sur +Créer dans le coin supérieur droit de la page.

Sur la page Créer une connexion, renseignez les champs suivants :

• Dans le champ Nom, saisissez un nom pour la connexion. Le nom doit être unique et ne peut contenir que des lettres latines, des chiffres, des tirets et des traits de soulignement (par exemple, Deposits_Stripe).
• Dans le champ Libellé, saisissez un libellé qui sera attribué à la connexion dans le Back Office.
• Dans la liste déroulante Fournisseur, sélectionnez PaymentSystemDeposit.

Dans la liste déroulante Pilote qui apparaît, sélectionnez Stripe.

Dans la section Identifiants qui apparaît, configurez les paramètres propres à Stripe :

• Dans le champ URL de base de l’API, conservez la valeur par défaut https://api.stripe.com. La même URL est utilisée pour les environnements de production et de test.
• Dans le champ Clé secrète, saisissez la clé API secrète ou restreinte générée dans votre compte Stripe. L’environnement est déterminé par la clé : utilisez une clé de production pour l’environnement de production et une clé de test pour les tests.

Pour obtenir la clé, connectez-vous au Stripe Dashboard et accédez à Développeurs > Clés API (pour plus de détails, consultez Clés API).

Cliquez sur Enregistrer pour créer la connexion.

La connexion Stripe apparaît dans la liste des connexions externes.

Vérifiez le statut de la connexion.

Si la connexion est inactive (No s’affiche dans la colonne Activé), cliquez sur le bouton Modifier pour ouvrir les détails de la connexion et définissez la liste déroulante Activé sur Yes.

Cliquez sur Enregistrer pour appliquer les modifications.

Dans le Back Office de B2CORE, accédez à Système > Système de dépôt > Méthodes de dépôt.

Cliquez sur +Créer dans le coin supérieur droit de la page.

Sur la page Créer une méthode de dépôt, renseignez les champs suivants :

• Dans le champ Nom, saisissez un nom pour la méthode. Le nom doit être unique et ne peut contenir que des lettres latines, des chiffres, des tirets et des traits de soulignement.
• Dans le champ Libellé, saisissez un libellé pour la méthode. Ce libellé sera attribué à la méthode dans le Back Office et sera visible par les clients dans l’interface B2CORE.
• Dans la liste déroulante Fournisseur, sélectionnez PaymentSystemDeposit.

Après avoir sélectionné PaymentSystemDeposit, les champs suivants apparaissent :

• Dans la liste déroulante Devises de compte disponibles, sélectionnez une ou plusieurs devises. Les dépôts via Stripe seront disponibles pour les comptes libellés dans les devises sélectionnées.
• Dans la liste déroulante Pilote, sélectionnez Stripe.
• Dans la liste déroulante Connexion, sélectionnez la connexion Stripe configurée précédemment.

Cliquez sur Enregistrer pour créer la méthode de dépôt.

La méthode de dépôt Stripe apparaît dans la liste des méthodes de dépôt.

Cliquez sur Modifier pour accéder aux détails de la méthode et renseigner les éléments suivants :

• Dans l’onglet Paramètres, utilisez la liste déroulante Groupe pour sélectionner un ou plusieurs groupes dans lesquels la méthode doit figurer.

• Dans le champ Icône, indiquez paymethod-stripe pour afficher l’icône prédéfinie de la méthode de dépôt Stripe dans l’interface B2CORE. Pour utiliser une icône personnalisée, indiquez l’URL de l’image à afficher.

• Vérifiez le statut de la méthode.

  Si la méthode est inactive (No s’affiche dans le champ Activé), activez-la en définissant la liste déroulante Activé sur Yes.

• Dans l’onglet Devises du système de paiement, ajoutez les devises nécessaires, telles que EUR, GBP et USD. Les dépôts via Stripe seront traités dans les devises ajoutées à cet onglet (pour une description de l’onglet, consultez Méthodes de dépôt).

• Si nécessaire, configurez les commissions de la méthode dans l’onglet Commissions (pour plus de détails, consultez Comment configurer les commissions pour les méthodes de dépôt et de retrait).

Cliquez sur Tester la configuration pour valider les paramètres de connexion de la méthode de dépôt. Le test est effectué à partir des paramètres indiqués dans le formulaire de la méthode et des données fournies dans la connexion externe sélectionnée.

Le résultat du test s’affiche sur la page.

Une fois la configuration validée, cliquez sur Enregistrer.

Dans le Back Office de B2CORE, accédez à Système > Système de dépôt > Méthodes de dépôt.

Trouvez la méthode de dépôt Stripe configurée et cliquez sur Modifier pour accéder aux détails de la méthode.

Accédez à l’onglet Webhooks.

Copiez l’URL affichée dans le champ URL de notification.

Connectez-vous au Stripe Dashboard, accédez à Développeurs > Webhooks et commencez à créer une destination d’événement.

À l’étape Sélectionner les événements, configurez les paramètres suivants :

• Sous Portée de la destination d’événement, sélectionnez Votre compte.

• Sous Format de la charge utile, sélectionnez Snapshot. B2CORE lit l’identifiant de la session Checkout dans la charge utile de l’événement, qui n’est pas inclus dans les charges utiles allégées.

• Sous Événements, sélectionnez les événements suivants (ils figurent dans le groupe Checkout) :

  • checkout.session.completed
  • checkout.session.async_payment_succeeded
  • checkout.session.async_payment_failed
  • checkout.session.expired

À l’étape Choisir le type de destination, sélectionnez Point de terminaison webhook.

À l’étape Configurer votre destination, renseignez les champs suivants :

• Dans le champ Nom de la destination, saisissez un nom pour la destination ou conservez celui qui a été généré.
• Dans le champ URL du point de terminaison, collez l’URL du webhook copiée depuis le Back Office de B2CORE.
• Si nécessaire, ajoutez une Description de la destination.

Cliquez sur Créer la destination.