Installer et configurer le connecteur de paiement Stripe à partir de Commercetools

Installez et configurez le connecteur à partir de la place de marché Connect dans votre vitrine Commercetools.

Avant d’installer le Stripe Payment Connector :

Identifiez l’organisation et le projet dans l’instance Commercetools dans laquelle vous souhaitez installer le connecteur.
Préparez-vous à configurer et à installer le connecteur directement à partir de votre instance Commercetools.

Installer le connecteur de paiement Stripe

Sélectionnez le Stripe Payment Connector dans la place de marché de Commercetools Connect au sein de votre instance Commercetools.
Liste des connecteurs dans la vue du projet Commercetools
Choisissez la région, le ou les projets et l’organisation requis pour installer le connecteur.
Configuration du projet Commercetools
Saisissez les détails de votre configuration et les informations relatives à l’environnement
Variables d’environnement et configuration des connecteurs
Créez un webhook dans le Dashboard Stripe avec une URL de transaction test et assurez-vous de copier la clé secrète de signature du webhook.
L’URL de cette transaction test est mise à jour automatiquement par un script post-déploiement du connecteur de paiement avec l’URL correcte.

Configurer le connecteur de paiement Stripe

CTP_PROJECT_KEY : la clé du projet de commerce composable Commercetools.
CTP_SCOPE : le champ d’application restreint les endpoints auxquels le client Commercetools a accès, ainsi que le droit d’accès en lecture et en écriture à un endpoint.
CTP_AUTH_URL : l’URL pour l’authentification dans la plateforme Commercetools. Elle est utilisée pour générer un token OAuth 2.0 nécessaire dans chaque appel à l’API du commerce composable Commercetools. La valeur par défaut est : https://auth.europewest1.gcp.commercetools.com.
CTP_API_URL : l’URL pour l’API de commerce composable Commercetools. La valeur par défaut est : https://api.europe-west1.gcp.commercetools.com.
CTP_SESSION_URL : l’URL pour la création d’une session dans la plateforme Commercetools. Les connecteurs s’appuient sur la session créée pour pouvoir partager des informations entre le facilitateur et le processeur. La valeur par défaut est : https://session.europewest1.gcp.commercetools.com.
CTP_JWKS_URL : l’URL qui fournit le jeu de clés Web JSON.
CTP_JWT_ISSUER : l’émetteur à l’intérieur du Token Web JSON qui est requis dans le processus de validation JWT.
STRIPE_CAPTURE_METHOD : la méthode de capture Stripe (manuelle ou automatique). La valeur par défaut est : automatic.
STRIPE_APPEARANCE_PAYMENT_ELEMENT : les Stripe Elements prennent en charge la personnalisation visuelle, ce qui vous permet de faire correspondre le design de votre site avec l’option d’apparence. Cette valeur définit l’apparence spécifique du composant Payment Element.
STRIPE_APPEARANCE_EXPRESS_CHECKOUT : Stripe Elements prend en charge la personnalisation visuelle, ce qui vous permet de faire correspondre le design de votre site avec l’option d’apparence. Cette valeur a l’apparence spécifique du composant Express Checkout Element.
CTP_CLIENT_SECRET : la clé secrète du client du compte utilisateur de commerce composable Commercetools. Elle est utilisée dans le client Commercetools pour communiquer avec le commerce composable Commercetools via le SDK.
CTP_CLIENT_ID : l’identifiant client de votre compte utilisateur du commerce composable Commercetools. Il est utilisé dans le client Commercetools pour communiquer avec le commerce composable Commercetools via le SDK.
STRIPE_SECRET_KEY: Stripe authenticates your API requests using your account’s API keys. It is highly recommended to create a restricted access key for this and not use the default API Secret key
STRIPE_WEBHOOK_ID : l’identifiant unique de Stripe pour les endpoints de webhook.
STRIPE_WEBHOOK_SIGNING_SECRET : la clé secrète de Stripe pour vérifier les signatures des webhooks à l’aide des bibliothèques officielles. Cette clé est créée dans le Dashboard Stripe.

Le connecteur de paiement crée deux liens principaux :

Composant du JS Enabler du connecteur de paiement : l’URL dans laquelle les composants de paiement sont intégrés (par exemple, https://assets-{{uuid}}.assets.uscentral1.gcp.preview.commercetools.app/connector-enabler.es.js)
Processeur du connecteur de paiement : l’URL dans laquelle tous les webhooks sont envoyés et transformés en transactions de paiement dans Commercetools (par exemple, https://service-{{uuid}}.uscentral1.gcp.preview.commercetools.app)

Développer l’intégration de paiement

Si vous souhaitez développer et enrichir l’intégration de paiement existante pour répondre à vos besoins spécifiques :

Utilisez la base de code du connecteur disponible sur GitHub.
Déployez le connecteur localement.
Mettez à jour la configuration .env dans le processeur et le facilitateur.

En choisissant cette voie, vous êtes responsable du déploiement et de la configuration du connecteur.

Paramètres généraux

Vous pouvez modifier le mode de capture des composants générés par le facilitateur du connecteur de paiement dans la configuration de ce dernier (manuel ou automatique).
Le facilitateur du connecteur de paiement gère les composants de paiement connectés au processeur du connecteur de paiement.
Le processeur du connecteur de paiement crée le PaymentIntent dans Stripe avec les métadonnées correspondantes, et convertit les événements de webhook en transactions de paiement dans Commercetools.
Vous pouvez modifier l’apparence des composants Stripe Paiement Element et Express Checkout Element à partir de la configuration du connecteur de paiement.

Webhooks

Stripe utilise des webhooks pour informer votre application lorsqu’un événement se produit sur votre compte. Les webhooks sont utiles pour mettre à jour les transactions de paiement lorsque la banque du client confirme ou refuse un paiement, ou lorsque le paiement est annulé ou remboursé.

Nous prenons en charge les webhooks suivants :

charge.succeeded : si le paiement n’a pas été capturé, créez un nouveau paiement dans Commercetools. Si le paiement a été effectué, ajoutez-y une transaction « Authorization:Success »
payment_intent.succeeded: il existe deux façons de gérer cet événement :
- Méthode de capture automatique : si paymentIntent.capture_method est automatique, créez un nouveau paiement dans Commercetools et ajoutez-y une transaction « Charge:Success »
- Méthode de capture manuelle : si paymentIntent.capture_method est manuel, ajoutez une transaction « Charge:Success » au paiement dans Commercetools.
charge.refunded : si charge.captured est vrai, ajoutez une transaction « Refund:Success » au paiement dans Commercetools.
payment_intent.canceled : ajoutez une transaction « CancelAuthorization:Success » au paiement dans Commercetools.
payment_intent.payment_failed : enregistre les informations dans l’application du connecteur dans les logs du processeur.
payment_intent.requires_action : enregistre les informations dans l’application du connecteur dans les logs du processeur.