Connecteur Stripe pour Salesforce Order Management

Stripe Connector pour Salesforce Order Management est un paquet géré que vous installez en plus d’Order Management afin d’activer la capture et le remboursement des paiements pour les cas d’usage pris en charge par la gestion des commandes. Il comprend un adaptateur asynchrone et synchrone pour gérer les paiements et remboursements.

Avant de commencer

1. Une vitrine hébergée sur Salesforce B2C Commerce Cloud et Salesforce Order Management sur la plateforme principale Salesforce.
2. Cartouche Salesforce Commerce Cloud pour l’encaissement des paiements avec Stripe ou Salesforce sur Commerce Cloud.
3. Une intégration activée entre SalesforceB2C Commerce Cloud et Salesforce Order Management.
4. Accès à l’API CommercePayments activé par l’autorisation d’organisation PaymentPlatform.
5. Salesforce CommercePayments est uniquement disponible pour les organisations disposant de l’API en version 49.0 ou ultérieure. CommercePayments est uniquement disponible dans Lightning Experience.

Concepts principaux

PaymentIntent

Un PaymentIntent Stripe est une transaction créée par Stripe pour suivre un paiement depuis sa création jusqu’au processus de règlement, qui déclenche les étapes d’authentification supplémentaires requises, le cas échéant. L’utilisation de PaymentIntents nécessite que vous implémentiez l’API Payment Intents. Pour trouver le PaymentIntent dans Salesforce Order Management, examinez le champ Gateway Reference Number (GatewayRefNumber) de l’enregistrement d’autorisation de paiement associé au récapitulatif de commande.

Autorisation de paiement

Une autorisation de paiement concerne à la fois Stripe et Salesforce OMS. Un montant autorisé est la somme transmise par une entreprise à un prestataire de cartes bancaires pour vérifier que son client dispose de suffisamment de fonds pour effectuer l’achat en question.

Il existe deux modes de capture dans la cartouche Stripe LINK pour Salesforce B2C Commerce Cloud : l’autorisation et la capture. Si la cartouche LINK est configurée pour autoriser le paiement lors du règlement, Salesforce Order Management crée un enregistrement d’autorisation de paiement. Vous pouvez consulter l’autorisation de paiement associée à un récapitulatif de commande en suivant ce chemin d’accès :

Order Summary Record > Order Payment Summary Record > Payment Authorizations dans l’onglet Related

Si dans l’onglet Related, vous ne voyez pas Refunds, contactez votre administrateur Salesforce en joignant la liste des autorisations de paiement dans la présentation de la page (comme illustré) :

L’ID du PaymentIntent (pi_XXXXXX) Stripe est enregistré dans le champ de numéro de référence de la passerelle (GatewayRefNumber) de l’enregistrement d’autorisation de paiement. Le Mode de traitement (ProcessingMode) est défini sur External, ce qui signifie que l’autorisation de paiement a été traitée en dehors de la plateforme de paiement Salesforce.

Paiement

Si le mode de capture dans la cartouche Stripe LINK est défini sur Capture, le paiement du client est capturé. Dans ce cas, un enregistrement de paiement est créé dans Salesforce Order Management. Vous pouvez consulter le paiement associé à un récapitulatif de commande en suivant ce chemin d’accès :

Order Summary Record > Order Payment Summary Record > Payments in Related Tab

Si dans l’onglet Related, vous ne voyez pas Refunds, contactez votre administrateur Salesforce en joignant la liste des paiements dans la présentation de la page (comme illustré) :

ID de l’opération sur solde

L’ID de l’opération sur solde (txn_XXXXXXXXX) associée au PaymentIntent (pi_XXXXXX) Stripe est stocké dans le champ de numéro de référence de la passerelle (GatewayRefNumber). Le mode de traitement (ProcessingMode) est défini sur External, ce qui signifie que le paiement a été traité en dehors de la plateforme de paiement Salesforce. Si le paiement a été autorisé dans Salesforce B2C Commerce Cloud Storefront et que le montant a été capturé dans Salesforce OMS ultérieurement, l’enregistrement du paiement est représenté comme suit :

L’ID de la passerelle de paiement Salesforce (SFXXXXX) associé au Payment Intent (pi_XXXXXX) sur Stripe est stocké dans le champ de numéro de référence de la passerelle (GatewayRefNumber). La valeur du champ de mode de traitement (ProcessingMode) est définie sur Salesforce, ce qui signifie que le paiement a été traité par la plateforme de paiement Salesforce.

Remboursement

Si un remboursement est initié depuis Salesforce OMS, vous pouvez trouver l’enregistrement de remboursement correspondant en suivant ce chemin d’accès :

Order Summary Record > Order Payment Summary Record > Refunds (dans l’onglet « Related »)

Si dans l’onglet Related, vous ne voyez pas Refunds, contactez votre administrateur Salesforce en joignant la liste des remboursements dans la présentation de la page (comme illustré) :

L’ID de la passerelle de paiement Salesforce (SFXXXXX) est stocké dans le champ de numéro de référence de la passerelle (GatewayRefNumber). Le mode de traitement (ProcessingMode) est défini sur Salesforce, ce qui signifie que le remboursement a été traité par la plateforme de paiement Salesforce.

Logs de la passerelle de paiement

Vous pouvez afficher les logs des transactions effectuées avec la plateforme Salesforce en accédant à Order Summary Record > Order Payment Summary Record > Gateway Logs dans l’onglet Related. Si vous ne voyez pas les logs de passerelle dans l’onglet Related, contactez votre administrateur Salesforce en joignant les logs de passerelle dans la présentation de page associée, ou exécutez cette requête SOQL dans la console des développeurs ou avec SOQL Builder dans VS Code :

SELECT Id, OrderPaymentSummaryId, ReferencedEntityId, Request, Response, SfRefNumber, SfResultCode, GatewayRefNumber, GatewayAuthCode, GatewayDate, GatewayMessage, GatewayResultCode, GatewayResultCodeDescription, InteractionStatus FROM PaymentGatewayLog