Zahlungsintegration einrichten

Ermöglichen Sie Ihrer Power Pages-Website, Zahlungen zu akzeptieren, indem Sie den Arbeitsbereich „Einrichten“ des Designstudios verwenden. Mit dieser Integration ohne Code können Sie Ihrem mehrstufigen Formular eine Zahlungskomponente hinzufügen und so Ihre Website mit einem Zahlungsanbieter integrieren.

Um Zahlungen auf Ihrer Power Pages-Website zu akzeptieren, müssen Sie wie folgt vorgehen:

Schritt 1: Das Paket installieren. In diesem Schritt installiert der Websiteadministrierende das Paket, das aus erforderlichen Tabellen und anderen Voraussetzungen besteht, damit in der Umgebung Zahlungen möglich sind.

Schritt 2: Anbieter konfigurieren. In diesem Schritt konfiguriert der Websiteadministrierende oder Erstellende bestimmte für den jeweiligen Zahlungsanbieter spezifische Schlüssel.

Schritt 3: Die Zahlungsoption auf Ihrem Formular aktivieren. In diesem Schritt fügt der Erstellende das Formular ein und aktiviert die digitalen Zahlungen im entsprechenden Schritt des mehrstufigen Formulars.

Wichtig

• Diese Funktion funktioniert nur mit dem erweiterten Datenmodell.
• Diese Funktion erfordert Power Pages-Website-Build-Version 9.5.10.x, damit die Zahlungssteuerung auf der Website angezeigt wird.

Anforderungen

• Melden Sie sich für ein Konto bei Stripe als Zahlungsanbieter an und holen Sie sich den Testmodus- oder Liveschlüssel über die auf dem Stripe-Marketplace installierte Zahlungs-App.
• Erstellen oder identifizieren Sie eine Microsoft Dataverse Tabelle, die Sie in einem mehrstufigen Formular verwenden möchten. Diese Tabelle muss über einen Währungsfeldtyp verfügen, der zum Abrechnen des Betrags verwendet wird, den Sie vom Websitebenutzenden einziehen möchten. Weitere Informationen finden Sie unter So erstellen und ändern Sie Dataverse-Tabellen mithilfe des Arbeitsbereich „Daten“.
• Konfigurieren Sie ein mehrstufiges Formular mithilfe einer Dataverse-Tabelle, das über einen Schritt verfügt, in dem Benutzende bezahlen können. In diesem Schritt wird das Zahlungssteuerelement angezeigt, sobald es in einem späteren Schritt konfiguriert wurde.

Schritt 1: Installieren des Pakets

1. Wählen Sie im Designstudio Einrichten aus.
2. Wählen Sie unter Integrationen die Option Externe Apps aus.
3. Wählen Sie die Aktion Installieren für Stripe aus.
4. Sobald die Paketinstallation abgeschlossen ist, starten Sie die Website über Websiteaktionen im Admin Center neu.

Die Installationsaktion kann einige Minuten dauern. Die Aktion ändert sich auf „Verwalten“, sobald die Installation abgeschlossen ist.

Schritt 2: Den Anbieter konfigurieren

Sobald Sie das Paket installiert haben, können Sie mit der Konfiguration von Stripe für Ihre Power Pages-Website beginnen.

Schritt 2A: Besorgen Sie sich Ihre Stripe-Schlüssel

1. Wählen Sie im Designstudio Einrichten aus.

2. Wählen Sie unter Integrationen die Option Externe Apps aus.

3. Wählen Sie in der Integrationstabelle die Aktion Verwalten für Stripe aus.

4. Gehen Sie zum Stripe Marketplace und installieren Sie die Microsoft Power Pages Zahlungs-App.

5. Rufen Sie, nachdem die App installliert wurde, Veröffentlichbaren und Eingeschränkten Schlüssel ab, die Sie zum Aktivieren dieser Integration brauchen. Diese Werte werden in späteren Schritten benötigt.

   Anmerkung

   • Für den geheimen Schlüssel empfehlen wir die Verwendung der von Stripe bereitgestellten eingeschränkten API-Schlüssel, um den Zugriff und die Berechtigungen für verschiedene Bereiche Ihrer Kontodaten in Stripe einzuschränken.
   • In Version 9.6.3.x wurde zusätzlich zu den Testmodusschlüssel auch die Unterstützung für den Livemodusschlüssel hinzugefügt. Informationen zu den verschiedenen Schlüsseltypen finden Sie in der Dokumentation zu API-Schlüsseln von Stripe.

Schritt 2b: Wählen Sie Ihren Speichertyp

Sie können Dataverse (unterstützt nur den Testmodus) oder Azure Key Vault (unterstützt sowohl den Testmodus als auch den Livemodus) verwenden, um die Stripe-API-Schlüssel zu speichern.

Wenn Sie Dataverse auswählen, fahren Sie mit Schritt 2d (Ihre Schlüssel zu Ihrer Konfiguration hinzufügen) fort.

Wenn Sie Azure Key Vault verwenden, fügen Sie den eingeschränkten Stripe-Schlüssel als Geheimnis in einem Schlüsseltresor hinzu und weisen Sie Ihrer Website Berechtigungen zu, indem Sie Schritt 2c (Azure Key Vault konfigurieren (optional)) ausführen.

Schritt 2c: Azure Key Vault konfigurieren (optional)

Wenn Sie Azure Key Vault als Speichertyp auswählen, führen Sie die folgenden Schritte aus.

1. Rufen Sie im Azure-Portal unter App-Registrierungen den Namen Ihrer App ab, der Ihrer Power Pages-Website entspricht.

   Der App-Name ist der gleiche wie der Name Ihrer Website, hat aber das Präfix „Portals-“. Wenn Ihr Websitename Woodgrove-Bankanwendungen lautet, dann lautet der App-Name im Azure-Portal Portals-Woodgrove-Bankanwendungen. Notieren Sie sich diesen App-Registrierungsnamen für die Verwendung in den folgenden Schritten.

   

2. Melden Sie sich beim Azure-Portal an, um zu den Schlüsseltresoren zu navigieren.

3. Wählen Sie einen neuen Schlüsseltresor aus oder erstellen Sie einen neuen. Beim Erstellen eines neuen Schlüsseltresors müssen Sie ein Berechtigungsmodell auswählen. Sie können sich entweder für die rollenbasierte Zugriffssteuerung von Azure oder eine Key-Vault-Zugriffsrichtlinie entscheiden. Um die entsprechenden Schritte anzuzeigen, wählen Sie die folgende Registerkarte basierend auf dem von Ihnen gewählten Berechtigungsmodell aus.

   Rollenbasierte Zugriffssteuerung in Azure

   1. Navigieren Sie im Azure-Portal zu Ihrem Schlüsseltresor.
   2. Wählen Sie im Menü auf der linken Seite Zugriffssteuerung (IAM) aus.
   3. Wählen Sie oben auf der Seite + Hinzufügen und dann Rollenzuweisung hinzufügen aus.
   4. Suchen Sie auf der Registerkarte Stellenfunktionsrollen nach dem Rollennamen Geheimer Key-Vault-Schlüssel – Benutzender, wählen Sie erst ihn und dann Weiter aus.
   5. Wählen Sie bei Zugriff zuweisen zu Benutzender, Gruppe oder Dienstprinzipal aus.
   6. Wählen Sie + Mitglieder auswählen aus, und suchen Sie nach dem App-Registrierungsnamen Ihrer Website, wie am Anfang von Schritt 2c beschrieben.
   7. Wählen Sie die App für Ihre Website und dann Weiter aus.
   8. Wählen Sie Überprüfen + zuweisen.

   Key Vault-Zugriffsrichtlinien

   1. Wählen Sie im Menü auf der linken Seite Zugriffsrichtlinien aus.
   2. Wählen Sie oben auf der Seite + Erstellen aus.
   3. Wählen Sie unter Berechtigungen – geheime Schlüssel Abrufen>Weiter aus.
   4. Suchen Sie nach dem App-Registrierungsnamen Ihrer Website, wie am Anfang von Schritt 2c beschrieben.
   5. Wählen Sie die App für die Website und dann Weiter aus.
   6. Wählen Sie Erstellen aus.

   Ihre Website verfügt jetzt über Berechtigungen zum Lesen von geheimen Schlüsseln aus diesem Schlüsseltresor.

4. Fügen Sie Ihren eingeschränkten Stripe-Schlüssel als Schlüssel zum Schlüsseltresor hinzu. Informationen zum Erstellen eines geheimen Schlüssels in Azure Key Vault finden Sie Ein Geheimnis aus Azure Key Vault über das Azure-Portal festlegen und abrufen.

Schritt 2d: Fügen Sie Ihre Schlüssel zu Ihrer Konfiguration hinzu

1. Geben Sie im Designstudio die Einstellungen im Bereich Integration aktivieren ein.

   Wenn Sie die Dataverse Speicheroption verwenden, geben Sie die veröffentlichbaren und geheimen Schlüssel ein.

   Wenn Sie die Schlüsseltresorspeicheroption verwenden, geben Sie den veröffentlichbaren Schlüssel, den Namen des Azure Key Vault und den Namen des geheimen Schlüssels ein.

2. Wählen Sie Speichern aus und schließen Sie den Bereich. Wenn beim Speichern ein Fehler auftritt, lesen Sie die Fehlermeldung, und beheben Sie die Probleme im Zusammenhang mit der Einrichtung von Key Vault.

3. Klicken Sie auf Sync.

Schritt 3: Die Zahlungsoption auf Ihrem Formular aktivieren

Gehen Sie wie folgt vor, um Zahlungen zu aktivieren:

1. Erstellen Sie einen mehrstufigen Formularschritt für die Dataverse-Tabelle, die in Ihrem mehrstufigen Formularprozess dort verwendet wird, wo Sie Zahlungen akzeptieren möchten.

2. Fügen Sie Tabellenberechtigungen für die Dataverse-Tabelle hinzu, die im mehrstufigen Formularprozess verwendet wird (Sie benötigen mindestens die Berechtigungen Erstellen und Schreiben) und weisen Sie Webrollen entsprechend zu.

3. Klicken Sie auf Sync.

4. Wählen Sie im Designstudio Seiten aus und navigieren Sie zu der Webseite, auf der die Zahlungsumgebung bereitgestellt werden soll.

5. Fügen Sie das mehrstufige Formular hinzu oder bearbeiten Sie es und erstellen Sie einen Schritt namens Zahlen (oder so ähnlich).

6. Machen Sie mit den Schritteinstellungen weiter.

   

   • Wählen Sie App-Integrationen aus.
   • Schalten Sie Digitale Zahlungen aktivieren um.
   • Wählen Sie im Feld Betrag auswählen das Währungstypfeld aus der Tabelle aus, das für den Betrag verwendet wird, den Sie vom Websitebenutzenden einziehen möchten.  

   Anmerkung

   Die Konfiguration von Zahlungsmethoden und weitere Einstellungen können direkt in Stripe vorgenommen werden. Sie erfordern möglicherweise die Annahme anderer Bedingungen und andere Konfigurationen.

Die Zahlungskontrolle wird automatisch zum Formularschritt hinzugefügt, der eine Vorschau der Zahlungsmethoden anzeigt, die für die Annahme von Zahlungen aktiviert sind.

Vorschau anzeigen und Ihre Webseite testen

Im Schritt „Bezahlen“ sollten Sie in der Lage sein, eine Zahlung mit Testkarten durchzuführen, die auf der Stripe-Website verfügbar sind.

Bei einer erfolgreichen Zahlung wird die Bestätigung mit dem gezahlten Betrag und einer vom Zahlungsanbieter zurückgegebenen Transaktions-ID angezeigt.

Anmerkung

Sie sollten die Schaltfläche „Zurück“ in den Schritteinstellungen deaktivieren, wenn Sie nicht möchten, dass Benutzende vom Zahlungsschritt zum vorherigen Schritt wechseln können.

Wenn dieser Schritt der letzte Schritt Ihres mehrstufigen Formulars ist, wird eine Schaltfläche zum Senden aktiviert, mit der das Formular übermittelt und der Vorgang abgeschlossen wird.

Zahlungsfunktion in einem Mandanten steuern

Ein Administrator kann Zahlungen in einem Mandanten deaktivieren, indem er die Einstellung auf Mandantenebene disablePaymentIntegrationForPages über PowerShell festlegt.

Zum Ausführen von PowerShell-Cmdlets müssen Sie zuerst die erforderlichen Module installieren.

Zahlungen deaktivieren

Nachdem Sie die Module installiert haben, führen Sie den folgenden Befehl in einem PowerShell-Fenster als Administrierender aus:

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

Administratoren sind Benutzer, die eine der folgenden Azure-Rollen haben:

• Dynamics 365-Administrator
• Power Platform Administrator

Wenn die Zahlungsfunktion in einem Mandanten deaktiviert ist:

• Erstellende sehen die folgende Umgebung im Bereich Externe Apps.

  

• Erstellende sehen auf der Registerkarte App-Integrationen einer mehrstufigen Formularkonfiguration die folgende Umgebung.

  

Jede Erfahrung enthält die folgende Nachricht:

„Diese Anwendung wurde von Ihrer Organisation deaktiviert. Wenden Sie sich zur Aktivierung an Ihre Systemadministration.“

Anmerkung

Sobald diese Mandanteneinstellung auf „Alle“ festgelegt ist, verhindert ab sofort sie die Einrichtung von Zahlungsfunktionen für weitere Websites. Dies hat keine Auswirkungen auf die Konfiguration und Zahlungseinrichtung auf Formularen, die Erstellende möglicherweise bereits in ihren Umgebungen vorgenommen haben.

Zahlungen aktivieren

Um die Zahlungsfunktion in einem Mandanten zu aktivieren, führen Sie den folgenden Befehl in einem PowerShell-Fenster als Administrator aus:

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

Überlegungen

• Zahlungswährungen und -beträge. Die Werte für den Mindest- und Höchstzahlungsbetrag können je nach Währung variieren. Gehen Sie die Stripe-Dokumentation zu unterstützten Währungen durch, um sicherzustellen, dass Ihr Formular und Ihre Tabellen richtig konfiguriert sind, um Zahlungen in diesem Bereich zu akzeptieren.

• Compliance mit dem Payment Card Industry Data Security Standard (PCI DSS). Dieses Feature verwendet den Zahlungsintegrationsansatz von Stripe Web Elements. Kartendaten werden dann nicht in Power Pages oder Dataverse gespeichert. Die PCI-Compliance ist eine gemeinsame Verantwortung und gilt auch für Unternehmen. Weitere Informationen zur Überprüfung Ihrer PCI-Compliance finden Sie in der Stripe-Dokumentation.

• Zahlungstabelle. Zum Speichern von Transaktionen wird mit der Lösung eine neue Zahlungstabelle installiert. Die Tabelle wird automatisch mit der Tabelle verknüpft, die Sie beim Konfigurieren der Formularschritte auswählen. In der Tabelle können Sie die Details zu Transaktionen und den Status anzeigen. Diese Tabelle ist nur eine Momentaufnahme der bereitgestellten Informationen, die Sie verwenden können, um andere Erfahrungen für Ihre im geschäftlichen Bereich tätigen Personen in Power Apps oder Power Pages zu erstellen. Informationen zu weiteren Details und zur Behebung zahlungsbezogener Probleme erhalten Sie bei dem Zahlungsanbieter, zum Beispiel dem Stripe-Dashboard.

• Webhook. Das Zahlungsfeature konfiguriert auch einen Webhook auf Stripe, der verwendet wird, um den Status von Zahlungen asynchron zu aktualisieren, deren Abschluss möglicherweise zusätzliche Zeit in Anspruch nimmt.

  Anmerkung

  Wenn sich eine Website im privaten Modus befindet, kann dieser Webhook möglicherweise nicht mit Power Pages kommunizieren und Sie erhalten daher möglicherweise E-Mails von Stripe. Dies ist ein zeitweise auftretendes Verhalten. Sobald Ihre Website in den öffentlichen Modus geschaltet wird, sollte der Webhook erfolgreich kommunizieren können.