Partager via

Configurer l’intégration de paiements

  • Article

Activez votre site Power Pages pour accepter les paiements à l’aide de l’espace de travail Configurer du studio de conception. Avec cette intégration sans code, vous pouvez ajouter un composant de paiement à votre formulaire à plusieurs étapes, permettant ainsi à votre site Web de s’intégrer à un fournisseur de paiement.

Une capture d’écran de l’intégration des paiements dans un site Power Pages.

Pour accepter les paiements dans votre site Power Pages, vous devez procéder comme suit :

Étape 1 : Installer le package. Dans cette étape, l’administrateur du site installe le package composé des tables requises et d’autres prérequis pour permettre à l’environnement d’activer l’expérience de paiements.

Étape 2 : Configurer le fournisseur. Dans cette étape, l’administrateur ou le créateur du site configure des clés spécifiques à un fournisseur de paiement.

Étape 3 : Activer l’expérience de paiements dans votre formulaire. Dans cette étape, le créateur inclut le formulaire et active les paiements numériques à l’étape requise pour le formulaire à plusieurs étapes.

Important

Conditions préalables

  • Créez un compte auprès de Stripe en tant que fournisseur de services de paiement et obtenez le mode test ou les clés de production à partir de l’application de paiement installée sur Stripe Marketplace.
  • Créez ou identifiez une Microsoft Dataverse table que vous souhaitez utiliser dans un formulaire à plusieurs étapes. Cette table doit avoir un type de champ de devise utilisé pour facturer le montant que vous souhaitez collecter auprès de l’utilisateur du site. Pour plus d’informations, consultez Comment créer et modifier des tables Dataverse à l’aide de l’espace de travail Données.
  • Configurez un formulaire à plusieurs étapes en utilisant une table Dataverse avec une étape pour permettre aux utilisateurs de payer. Cette étape affiche le contrôle de paiements une fois configuré à une étape ultérieure.

Étape 1 : Installer le package

  1. Dans le studio de conception, sélectionnez Configurer.
  2. Sous Intégrations, sélectionnez Applications externes.
  3. Sélectionnez l’action Installer pour Stripe.
  4. Une fois l’installation du package terminée, redémarrez le site Web à partir des Actions du site dans le centre d’administration.

L’action d’installation peut prendre quelques minutes. L’action change pour gérer une fois l’installation terminée.

Étape 2 : Configurer le fournisseur

Une fois que vous avez installé le package, vous pouvez commencer à configurer Stripe pour votre site Power Pages.

étape 2a : Obtenez vos clés Stripe

  1. Dans le studio de conception, choisissez Configurer.

  2. Sous Intégrations, sélectionnez Applications externes.

  3. Dans le tableau Intégrations, sélectionnez l’action Gérer pour Stripe.

  4. Accédez à Stripe Marketplace et installez l’application de paiements Microsoft Power Pages.

  5. Une fois l’application installée, obtenez les clés Publiables et Limitées requises pour activer cette intégration. Ces valeurs sont nécessaires dans les étapes ultérieures.

    Note

    • Pour la clé secrète, nous vous recommandons d’utiliser les clés d’API restreintes fournies par Stripe pour limiter l’accès et les autorisations pour différentes zones des données de votre compte dans Stripe.
    • La version 9.6.3.x a ajouté la prise en charge des clés en mode Live en plus des clés en mode Test. Pour comprendre les différents types de clés, consultez la documentation de Stripe sur les clés d’API.

étape 2b : Choisissez votre type de stockage

Vous pouvez utiliser Dataverse (prend uniquement en charge le mode Test) ou Azure Key Vault (prend en charge à la fois le mode Test et le mode Live) pour stocker les clés d’API Stripe.

Capture d’écran du panneau Activer l’intégration dans l’espace de travail de configuration de Power Pages Design Studio.

Si vous choisissez Dataverse, passez à l’étape 2d (Ajouter vos clés à votre configuration).

Si vous utilisez Azure Key Vault, ajoutez la clé Stripe Restricted comme secret dans un coffre-fort de clés et attribuez des autorisations à votre site en suivant étape 2c (Configurer Azure Key Vault (facultatif)).

étape 2c : Configurer le coffre-fort de clés Azure (facultatif)

Si vous choisissez Azure Key Vault comme type de stockage, procédez comme suit.

  1. Dans le portail Azure, obtenez le nom de votre application dans Inscriptions d’application qui correspond à votre site web Power Pages.

    Le nom de l’application est le même que le nom de votre site Web avec un préfixe « Portals- ». Si le nom de votre site est "Woodgrove Bank Applications", le nom de l’application sur le portail Azure est "Portals-Woodgrove Bank Applications". Notez le nom d’enregistrement de cette application pour l’utiliser dans les étapes suivantes.

    Recherchez les enregistrements d’application Capture d’écran du portail Azure pour un site Power Pages.

  2. Connectez-vous au portail Azure et accéder aux Coffres de clés.

  3. Créez une stratégie de coffre de clés ou utilisez-en une existante. Lors de la création d’un nouveau coffre-fort de clés, vous devez choisir un modèle d’autorisation. Vous pouvez choisir un contrôle d’accès en fonction du rôle Azure ou une stratégie d’accès au coffre de clés. Pour voir les étapes appropriées, Sélectionner l’onglet ci-dessous en fonction de votre choix de modèle d’autorisation.

    1. Accédez à votre coffre de clés dans le portail Azure.
    2. Sélectionnez Contrôle d’accès (IAM) dans le menu de gauche.
    3. Sélectionnez + Ajouter en haut de la page, puis sélectionnez Ajouter une attribution de rôle.
    4. Sous l’onglet Rôles de fonction de tâche, recherchez le nom du rôle Utilisateur des secrets de Key Vault, sélectionnez-le, puis sélectionnez Suivant.
    5. Pour Affecter l’accès, sélectionnez Utilisateur, groupe ou principal de service.
    6. Sélectionner + Sélectionner membres et recherchez le nom d’enregistrement de l’application de votre site comme décrit au début de étape 2c.
    7. Sélectionnez l’application pour votre site et sélectionnez Suivant.
    8. Sélectionnez Examiner + Attribuer.

    Votre site dispose désormais des autorisations nécessaires pour lire les secrets de ce coffre-fort de clés.

  4. Ajoutez votre clé restreinte Stripe en tant que secret au coffre-fort de clés. Pour savoir comment créer une clé secrète dans Azure Key Vault, accédez à Définir et récupérer une clé secrète à partir d’Azure Key Vault à l’aide du portail Azure.

Étape 2d : Ajouter vos clés à votre configuration

  1. Dans le studio de conception, saisissez les paramètres dans le volet Activer l’intégration.

    Si vous utilisez l’option de stockage Dataverse, entrez les clés publiables et secrètes.

    Si vous utilisez l’option de stockage Key Vault, entrez la clé publiable, le nom Azure Key Vault et le nom de la clé secrète.

  2. Cliquez sur Enregistrer et fermez le volet. Si vous rencontrez une erreur lors de l’enregistrement, reportez-vous au message d’erreur et résolvez les problèmes liés à la configuration du coffre-fort de clés.

  3. Sélectionnez Synchroniser.

Étape 3 : Activer l’expérience de paiements dans votre formulaire

Pour activer les paiements, procédez comme suit :

  1. Créez une étape de formulaire à plusieurs étapes pour la table Dataverse utilisée dans votre processus de formulaire à plusieurs étapes où vous souhaitez accepter les paiements.

  2. Ajoutez des autorisations de table pour les tables Dataverse utilisées dans le processus de formulaire à plusieurs étapes (au moins les autorisations Créer et Écrire sont nécessaires) et attribuez les rôles Web appropriés.

  3. Sélectionnez Synchroniser.

  4. Dans le studio de conception, sélectionnez Pages et accédez à la page Web où l’expérience de paiement est prévue.

  5. Ajoutez ou modifiez le formulaire à plusieurs étapes et créez une étape appelée Payer (ou similaire).

  6. Passez à Paramètres de l’étape.

    Capture d’écran des options de paramètres étape dans l’espace de travail Pages du studio de design. Power Pages

    • Sélectionnez Intégrations d’application.
    • Activez l’option Activer les paiements numériques.
    • Dans Choisir le champ du montant, sélectionnez le champ du type de devise dans la table utilisée pour facturer le montant que vous souhaitez collecter auprès de l’utilisateur du site.  

    Note

    La configuration des méthodes de paiement et d’autres paramètres peut être effectuée directement dans Stripe. Ils peuvent nécessiter l’acceptation d’autres termes et configurations.

Le contrôle de paiement est automatiquement ajouté à l’étape du formulaire qui affiche un aperçu des méthodes de paiement activées pour accepter les paiements.

Prévisualiser et tester votre page Web

À l’étape Payer, vous devriez pouvoir effectuer un paiement en utilisant les cartes de test disponibles sur le site Web de Stripe.

Un paiement réussi affiche la confirmation avec le montant payé et un ID de transaction renvoyé par le fournisseur de paiement.

Note

Vous devez désactiver le bouton de retour dans les paramètres de l’étape si vous ne souhaitez pas autoriser les utilisateurs à passer à l’étape précédente à partir de l’étape de paiement.

Si ce étape est le dernier étape de votre formulaire à plusieurs étapes, un bouton d’envoi est activé qui soumet le formulaire et termine votre processus.

Fonctionnalité de contrôle des paiements dans un client

Un administrateur peut désactiver les paiements dans un client en définissant le paramètre au niveau du client disablePaymentIntegrationForPages via PowerShell.

Pour exécuter des applets de commande PowerShell, vous devez au préalable installer les modules requis.

Désactiver les paiements

Après avoir installé les modèles, exécutez la commande suivante dans une fenêtre PowerShell en tant qu’administrateur :

$requestBody = @{
     powerPlatform = @{
         powerPages = @{
             disablePaymentIntegrationForPages = "All"
         }
     }
 }
 Set-TenantSettings -RequestBody $requestBody

Les administrateurs correspondent aux utilisateurs ayant l’un des rôles Azure suivants :

Lorsque la fonctionnalité de paiement est désactivée dans un client :

  • Les auteurs verront ce qui suit dans la zone Applications externes.

    Capture d’écran du volet Activer l’intégration avec l’intégration des paiements Stripe affiché comme bloqué.

  • Les auteurs verront ce qui suit dans l’onglet Intégrations d’application d’une configuration de formulaire à plusieurs étapes.

    Capture d’écran de l’onglet Intégrations d’applications d’un formulaire en plusieurs étapes.

Chaque expérience comprend le message suivant :

« Cette application a été désactivée par votre organisation. Contactez votre administrateur pour l’activer. »

Note

Une fois que ce paramètre de client est défini sur Tout, il empêche la configuration de la fonctionnalité de paiement à l’avenir pour d’autres sites. Cela n’a aucun impact sur la configuration et le paiement sur les formulaires qui peuvent déjà avoir été remplis par les auteurs dans leurs environnements.

Activer les paiements

Pour activer la fonctionnalité des paiements dans un locataire, exécutez la commande suivante dans une fenêtre PowerShell en tant qu’administrateur :

$requestBody = @{
     powerPlatform = @{
         powerPages = @{
             disablePaymentIntegrationForPages = "None"
         }
     }
 }
 Set-TenantSettings -RequestBody $requestBody

Considérations

  • Devises et montants de paiement. Les valeurs du montant de paiement minimum et maximum peuvent varier selon les devises. Consultez la documentation de Stripe sur les devises prises en charge pour garantir que votre formulaire et vos tables sont correctement configurés pour accepter les paiements dans cette plage.

  • Norme de sécurité des données (DSS) de l’industrie des cartes de paiement (PCI). Cette fonctionnalité utilise l’approche d’intégration de paiement Éléments web Stripe et les données de carte ne sont pas stockées dans Power Pages ou Dataverse. La conformité PCI est une responsabilité partagée et s’applique également à l’entreprise. Consultez la documentation de Stripe sur la validation de votre conformité PCI.

  • Table des paiements. Pour stocker les transactions, une nouvelle table des paiements est installée avec la solution. La table est automatiquement liée à la table que vous choisissez lorsque vous configurez les étapes du formulaire. Vous pouvez utiliser la table pour voir les détails des transactions et leur statut. Cette table n’est qu’un instantané des informations fournies, que vous pouvez utiliser pour créer d’autres expériences pour vos utilisateurs métier dans Power Apps ou Power Pages. Pour obtenir plus de détails et pour résoudre les problèmes liés au paiement, vous devez vous fier au fournisseur de paiement, tel que le tableau de bord de Stripe.

  • Webhook. La fonctionnalité de paiements configure également un webhook dans Stripe qui est utilisé pour mettre à jour de manière asynchrone le statut des paiements qui peuvent nécessiter plus de temps pour s’exécuter.

    Note

    Lorsqu’un site Web est en mode privé, ce webhook peut ne pas être en mesure de communiquer avec Power Pages et, par conséquent, vous pouvez recevoir des e-mails de Stripe. Il s’agit d’un comportement intermittent et une fois que votre site Web passe en mode public, le webhook devrait pouvoir communiquer correctement.