Configuration de passerelles de paiement tierces

Configuration initiale de la passerelle de paiement tierce

1. Créez un compte de commerçant e-commerce dans la passerelle de paiement tierce que vous souhaitez implémenter.
   1. Connectez-vous à votre fournisseur de passerelle de paiement tiers et ajoutez un compte de commerçant e-commerce.
   2. Accédez à la section Gestion des clés, développeur ou paramètres avancés de la plate-forme de passerelle de paiement que vous avez choisie, puis générez une clé d'API ou une clé secrète.

      Votre clé d'API se présente comme suit : AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU.

   3. Notez le nom d'utilisateur et la clé d'API du compte marchand. Ils sont nécessaires pour créer les identifiants nommés.
2. Créez vos classes Apex passerelle de paiement dans votre organisation Salesforce.
   1. Obtenez auprès de votre fournisseur de passerelle de paiement ou AppExchange les détails de la classe d'adaptateur.
      Pour élaborer et configurer des adaptateurs de passerelle de paiement, consultez Adaptateurs de passerelle de paiement. Pour définir vos classes Apex, consultez Espace de noms Paiements Commerce.
   2. Enregistrez vos classes Apex. Notez le nom de l'adaptateur dont vous avez besoin pour créer votre fournisseur de passerelle de paiement.
3. Créez un identifiant nommé hérité dans votre organisation Salesforce pour spécifier les paramètres d'authentification et l'URL de votre point de terminaison d'appel externe Apex.
   1. Spécifiez un nom convivial pour l'étiquette et un identifiant unique pour le nom.
   2. Saisissez l'URL de votre passerelle de paiement tierce.
   3. Sélectionnez Principal nommé comme type d'identité et Authentification par mot de passe comme protocole d'authentification.
   4. Utilisez le nom d'utilisateur de votre compte marchand comme nom d'utilisateur. Utilisez la clé d'API en tant que mot de passe requis par votre fournisseur de passerelle de paiement.
   5. Enregistrez les identifiants nommés dont vous avez besoin pour créer votre passerelle de paiement.
4. Enregistrez votre site passerelle de paiement tiers dans votre organisation Salesforce pour vous assurer que les appels Apex depuis l'organisation vers le site passerelle de paiement réussissent.
   1. Saisissez un nom et une URL pour votre passerelle de paiement tierce.
   2. Marquez le site comme actif, puis enregistrez vos modifications.
5. Ajoutez l'URL de votre passerelle de paiement tierce en tant qu'URL approuvée dans votre organisation Salesforce.
   1. Saisissez un nom d'API.
   2. Saisissez l'URL de votre passerelle de paiement tierce.
   3. Marquez l'URL comme active, puis enregistrez vos modifications.
6. Activez et configurez votre site Salesforce pour pouvoir envoyer et recevoir des notifications de paiement depuis votre passerelle tierce.
   1. Saisissez une étiquette, un nom et une page d'accueil pour votre site.
   2. Définissez les paramètres d'accès public du site sur Accès invité à l'API Paiements.
   3. Enregistrez les détails de votre site.

Configuration des paramètres de notification dans votre passerelle de paiement tierce

La passerelle de paiement utilise un webhook pour envoyer des notifications à votre adaptateur de passerelle de paiement. Un webhook combine le point de terminaison de votre site et l'ID du fournisseur de la passerelle de paiement. Créez un webhook en saisissant une URL dans les paramètres de transport de notification standard de votre passerelle de paiement tierce.

1. Utilisez cette URL pour le point de terminaison de votre site, en remplaçant MyDomainName par le domaine et l'URL de votre site. Par exemple :
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. Recherchez l’ID de votre fournisseur de passerelle de paiement et ajoutez le paramètre de requête ?provider=ID au point de terminaison. Par exemple, https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. Saisissez le webhook dans les paramètres de notification standard de votre passerelle de paiement tierce.

Configuration du fournisseur de la passerelle de paiement et de la passerelle de paiement

Ajoutez un fournisseur de passerelle de paiement après avoir configuré votre compte marchand, vos classes d'adaptateur et votre site Salesforce. Ajoutez ensuite une passerelle de paiement au fournisseur de la passerelle de paiement.

1. Dans Configuration, saisissez Facturation dans la case Recherche rapide, puis sélectionnez Étape 7 : Configurations de paiement dans Configuration guidée.
2. Agrandissez l'étape Configurer des passerelles de paiement tierces, cliquez sur Configurer des passerelles de paiement, puis sur Configurer.
   

   Remarque

   Pour les organisations Salesforce créées dans Winter ’26, le bouton Configurer des passerelles de paiement à l’étape 7 : Configurations de paiement de la Configuration guidée de facturation, qui redirige les utilisateurs vers l’onglet Configuration de la passerelle de paiement, est disponible par défaut. Pour les organisations Salesforce créées avant Winter ’26, l'onglet Configuration de la passerelle de paiement n'est pas disponible par défaut. Pour corriger ce problème, changez les paramètres de l'onglet Configuration de la passerelle de paiement sur Valeur par défaut activée.

3. Complétez ces champs pour créer un fournisseur de passerelle de paiement.
   1. Saisissez un nom et une étiquette uniques pour votre fournisseur de passerelle de paiement.
   2. Sélectionnez la classe d'adaptateur Apex dans la liste déroulante.
   3. Spécifiez votre support requis pour l'idempotency. Pour plus de détails, consultez Lignes directrices sur l'immunité.
   4. Enregistrez les détails du fournisseur de la passerelle de paiement.
4. Complétez ces champs pour ajouter une passerelle de paiement.
   1. Saisissez un nom unique pour votre passerelle de paiement.
   2. Sélectionnez un fournisseur de passerelle de paiement dans la liste déroulante.
   3. Sélectionnez un identifiant nommé dans la liste déroulante.
   4. Marquez le statut de votre passerelle de paiement comme Actif.
   5. Enregistrez les détails de la passerelle de paiement.

   Si vous avez déjà un fournisseur de passerelle de paiement, sélectionnez Étape 7 : Configurations de paiement dans la Configuration guidée, agrandissez l’étape Configurer des passerelles de paiement tierces, puis cliquez sur Configurer des passerelles de paiement. Dans la page Configuration de la passerelle de paiement, cliquez sur Passerelles de paiement, puis sur Nouveau. Les étapes de configuration sont les mêmes.

Ajout de plusieurs modes de paiement

Configurez la prise en charge des modes de paiement tels que la chambre de compensation automatisée (ACH), l'espace unique de paiement en euros (SEPA), les services de compensation automatisés des banquiers (BACS) et le système de compensation électronique en masse (BECS) sur votre passerelle de paiement tierce. Vous pouvez traiter les paiements, émettre des remboursements et afficher ces modes de paiement enregistrés sous l'onglet Modes de paiement enregistrés de votre profil de facturation.

• Pour ajouter des modes de paiement bancaire tels que ACH, SEPA, BACS et BECS, utilisez l'API tokenizePaymentMethod, puis définissez la propriété bankType de l'objet bankPaymentMethod sur le mode de paiement bancaire que vous avez choisi.
• Pour ajouter des modes de paiement par carte, tels que carte de crédit ou carte de débit, utilisez l'API tokenizePaymentMethod, puis définissez la propriété cardCategory dans l'objet cardPaymentMethod.