Integratie van betalingen instellen

Zorg ervoor dat uw Power Pages-site betalingen kan accepteren door de werkruimte Instellen van de ontwerpstudio te gebruiken. Met deze no-code-integratie kunt u een betalingscomponent toevoegen aan uw formulier voor meerdere stappen, waardoor uw website kan integreren met een betalingsprovider.

Om betalingen op uw Power Pages-site te kunnen accepteren, moet u deze stappen voltooien:

Stap 1: Het pakket installeren. In deze stap installeert de sitebeheerder het -pakket bestaande uit benodigde tabellen en andere vereisten voor de omgeving om de betalingservaring mogelijk te maken..

Stap 2: Provider configureren. In deze stap configureert de sitebeheerder of maker specifieke sleutels voor een betalingsprovider.

Stap 3: De betalingservaring inschakelen op uw formulier. In deze stap neemt de maker het formulier op en maakt digitale betalingen mogelijk in de vereiste stap voor het formulier voor meerdere stappen.

Vereisten

• Maak een account aan bij Stripe als uw betalingsaanbieder en ontvang de testmodus of de live-sleutels van de betalingsapp die u via Stripe Marketplace hebt geïnstalleerd.
• Maak of identificeer een Microsoft Dataverse-tabel die u wilt gebruiken in een fomulier voor meerdere stappen. Deze tabel moet een valutaveldtype hebben dat wordt gebruikt om het bedrag in rekening te brengen dat u wilt innen van de sitegebruiker. Zie voor meer informatie Dataverse-tabellen maken en wijzigen via de werkruimte Gegevens.
• Configureer een formulier voor meerdere stappen met een Dataverse-tabel die een stap bevat waarmee gebruikers betalingen kunnen doen. Bij deze stap wordt het betalingsbeheer weergegeven nadat het in een latere stap is geconfigureerd.

Stap 1: Het pakket installeren

1. Selecteer Instellen in de ontwerpstudio.
2. Selecteer onder Integraties de optie Externe apps.
3. Selecteer de actie Installeren voor Stripe.
4. Zodra de pakketinstallatie is voltooid, start u de website opnieuw op via Siteacties in het beheercentrum.

De installatieactie kan enkele minuten in beslag nemen. De actie verandert in beheren zodra de installatie is voltooid.

Stap 2: Provider configureren

Zodra u het pakket hebt geïnstalleerd, kunt u beginnen met de configuratie van Stripe voor uw Power Pages-site.

Stap 2a: Verkrijg uw Stripe-sleutels

1. Kies Instellen in de ontwerpstudio.

2. Selecteer onder Integraties de optie Externe apps.

3. Selecteer de actie Beheren voor Stripe in de tabel Integraties.

4. Ga naar de Stripe Marketplace en installeer de Microsoft Power Pages Payments-app.

5. Nadat de app is geïnstalleerd, moet u de Publiceerbaar- en Beperkt-sleutels ophalen die nodig zijn om deze integratie in te schakelen. Deze waarden zijn nodig in latere stappen.

   Notitie

   • Voor de geheime sleutel raden wij u aan de beperkte API-sleutels te gebuiken die Stripe biedt om de toegang en machtigingen voor verschillende delen van uw accountgegevens in Stripe te beperken.
   • In versie 9.6.3.x is naast testsleutels ook ondersteuning toegevoegd voor livesleutels. Raadpleeg Stripe-documentatie over API-sleutels voor meer informatie over de verschillende typen sleutels.

Stap 2b: Kies uw opslagtype

U kunt Dataverse (ondersteunt alleen de testmodus) of Azure Key Vault (ondersteunt zowel de testmodus als de livemodus) gebruiken om de Stripe API-sleutels op te slaan.

Als u Dataverse kiest, gaat u verder met stap 2d (Uw sleutels toevoegen aan uw configuratie).

Als u Azure Key Vault gebruikt, voegt u de beperkte Stripe-sleutel toe als geheim in een sleutelkluis en wijst u machtigingen toe aan uw site door stap 2c (Azure Key Vault configureren (optioneel)) te volgen.

Stap 2c: Azure Key Vault configureren (optioneel)

Als u Azure Key Vault als uw opslagtype kiest, voert u de volgende stappen uit.

1. Verkrijg in Azure Portal de naam van uw app in App-registraties die overeenkomt met uw Power Pages-website.

   De app-naam is gelijk aan de naam van uw website, met als voorvoegsel 'Portals-'. Als de naam van uw site Woodgrove Bank Applications is, dan is de app-naam in de Azure-portal Portals-Woodgrove Bank Applications. Noteer deze app-registratienaam voor gebruik in de volgende stappen.

   

2. Meld u aan bij Azure Portal en ga naar Key Vaults.

3. Maak een nieuwe sleutelkluis of gebruik een bestaande. Wanneer u een nieuwe sleutelkluis maakt, moet u een machtigingsmodel kiezen. U kunt kiezen uit op rollen gebaseerd toegangsbeheer van Azure of een Key Vault-toegangsbeleid. Om de juiste stappen te zien, selecteert u het onderstaande tabblad op basis van het door u gekozen machtigingsmodel.

   • Op rollen gebaseerd toegangsbeheer van Azure
   • Toegangsbeleid voor Key Vault

   1. Navigeer in uw sleutelkluis naar Azure Portal.
   2. Selecteer Toegangscontrole (IAM) in het linkermenu.
   3. Selecteer + Toevoegen bovenaan de pagina en selecteer vervolgens Roltoewijzing toevoegen.
   4. Zoek op het tabblad Functierollen naar de rolnaam Gebruiker van Key Vault-geheimen en selecteer Volgende.
   5. Bij Toegang toewijzen aan selecteert u Gebruiker, groep of service-principal.
   6. Selecteer + Leden selecteren en zoek naar de app-registratienaam van uw site zoals beschreven aan het begin van stap 2c.
   7. Selecteer de app voor uw site en selecteer Volgende.
   8. Selecteer Controleren + toewijzen.

   Uw site heeft nu toestemming om geheimen uit deze sleutelkluis te lezen.

4. Voeg uw beperkte Stripe-sleutel als geheim toe aan de sleutelkluis. Voor meer informatie over het maken van een geheim in Azure Key Vault, ga naar Een geheim instellen en ophalen uit Azure Key Vault via Azure Portal.

Stap 2d: Voeg uw sleutels toe aan uw configuratie

1. In de ontwerpstudio voert u de instellingen in het paneel Integratie inschakelen in.

   Als u de opslagoptie Dataverse gebruikt, voert u de publiceerbare en geheime sleutels in.

   Als u de opslagoptie Key Vault gebruikt, voert u de publiceerbare sleutel, Azure sleutelkluisnaam en geheime naam in.

2. Selecteer Opslaanen sluit het paneel. Als er een fout optreedt tijdens het opslaan, raadpleeg dan de foutmelding en los de problemen met de sleutelkluisconfiguratie op.

3. Selecteer Synchroniseren.

Stap 3: De betalingservaring inschakelen op uw formulier

Voer de volgende stappen uit om betalingen in te schakelen:

1. Maak een stap in een formulier voor meerdere stappen voor de Dataverse-tabel die in uw formulierproces voor meerdere stappen wordt gebruikt waarin u betalingen wilt accepteren.

2. Voeg tabelmachtigingen toe voor de Dataverse-tabellen die worden gebruikt in het uit meerdere stappen bestaande formulierproces (u hebt minstens de machtigingen Maken en Schrijven nodig) en geschikte webrollen toewijzen.

3. Selecteer Synchroniseren.

4. Selecteer in de ontwerpstudio Pagina's en navigeer naar de webpagina waar de betaalervaring moet plaatsvinden.

5. Voeg het formulier voor meerdere stappen toe of bewerk het en maak een stap met de naam Betalen (of vergelijkbaar).

6. Ga naar Stapinstellingen.

   

   • Selecteer App-integraties.
   • Schakel Digitale betalingen inschakelen in.
   • Selecteer in het veld Bedrag kiezen het veld voor het valutatype dat u wilt gebruiken om het bedrag van de sitegebruiker te innen in de tabel.  

   Notitie

   De configuratie van betalingsmethoden en meer instellingen kan rechtstreeks in Stripe plaatsvinden. Mogelijk vereisen ze acceptatie van andere voorwaarden en configuraties.

Het betalingsbeheer wordt automatisch toegevoegd aan de formulierstap die een voorbeeld toont van de betalingsmethoden die zijn ingeschakeld voor het accepteren van betalingen.

Bekijk en test uw webpagina

In de stap Betalen zou u een betaling moeten kunnen uitvoeren met behulp van testkaarten die beschikbaar zijn op de website van Stripe.

Bij een succesvolle betaling wordt de bevestiging getoond met het betaalde bedrag en wordt een transactie-id geretourneerd door de betalingsprovider.

Als deze stap de laatste stap van uw formulier voor meerdere stappen is, wordt een verzendknop weergegeven waarmee u het formulier kunt verzenden en het proces kunt voltooien.

Functie voor het beheren van betalingen in een tenant

Een beheerder kan betalingen in een tenant uitschakelen door de tenantniveau-instelling disablePaymentIntegrationForPages in te stellen via PowerShell.

Als u PowerShell-cmdlets wilt uitvoeren, moet u eerst de vereiste modules installeren.

Betalingen uitschakelen

Voer, na de installatie van de modules, de volgende opdracht uit in een PowerShell-venster uit als een beheerder:

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

Beheerders zijn de gebruikers die een van de volgende Azure-rollen hebben:

• Dynamics 365-beheerder
• Power Platform-beheerder

Wanneer de betalingsfunctie in een tenant is uitgeschakeld:

• Makers komen het volgende tegen op het gebied van externe apps.

  

• Makers komen het volgende tegen in het tabblad App-integraties van een configuratie van een formulier met meerdere stappen.

  

Elke ervaring bevat de volgende boodschap:

"Deze applicatie is door uw organisatie uitgeschakeld. Neem contact op met uw beheerder om dit in te schakelen."

Betalingen inschakelen

Om de betalingsfunctie in een tenant in te schakelen, voert u de volgende opdracht uit in een PowerShell-venster als beheerder:

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

Overwegingen

• Betalingsvaluta's en -bedragen. De minimale en maximale betalingsbedragen kunnen per valuta verschillen. Bekijk de Stripe-documentatie over ondersteunde valuta's om er zeker van te zijn dat uw formulier en tabellen correct zijn geconfigureerd om betalingen binnen dat bereik te accepteren.

• Payment Card Industry Data Security Standard (PCI DSS)-naleving. Deze functie maakt gebruik van de Stripe Web Elements-betalingsintegratiebenadering en kaartgegevens worden niet opgeslagen in Power Pages of Dataverse. PCI-naleving is een gedeelde verantwoordelijkheid en geldt ook voor de bedrijfsvoering. Zie de documentatie van Stripe over het valideren van uw PCI-naleving.

• Betalingstabel. Voor het opslaan van transacties is er een nieuwe betalingstabel bij de oplossing geïnstalleerd. De tabel wordt automatisch gerelateerd aan de tabel die u kiest wanneer u de formulierstappen configureert. U kunt de tabel gebruiken om de details van transacties en status te bekijken. Deze tabel is slechts een momentopname van de verstrekte informatie die u kunt gebruiken om andere ervaringen voor uw zakelijke gebruikers te creëren in Power Apps of Power Pages. Voor meer details en het oplossen van betalingsgerelateerde problemen kunt u zich richten tot een betalingsprovider, zoals het dashboard van Stripe.

• Webhook. De betalingsfunctie configureert ook een webhook op Stripe die wordt gebruikt om de status van betalingen asynchroon bij te werken, wat extra tijd kan kosten voor voltooiing.

  Opmerking

  Wanneer een website zich in de privémodus bevindt, kan deze webhook mogelijk niet communiceren met de Power Pages en ontvangt u daarom mogelijk e-mails van Stripe. Dit is periodiek gedrag en zodra uw website naar de openbare modus is overgeschakeld, zou de webhook succesvol moeten kunnen communiceren.