Konfigurera betalningsintegration

Aktivera din Power Pages-webbplats att acceptera betalningar genom att använda designstudions arbetsyta för konfigurering. Med denna integrering utan kod kan du lägga till en betalningskomponent i ditt flerstegsformulär, vilket gör att din webbplats kan integreras med en betalningsleverantör.

För att acceptera betalningar på din Power Pages webbplats måste du utföra dessa steg:

Steg 1: installera paketet. I det här steget installerar webbplatsadministratören paketet som består av obligatoriska tabeller och andra förutsättningar för att miljön ska möjliggöra betalningsupplevelse.

Steg 2: Konfigurera leverantör. I det här steget konfigurerar webbplatsens administratör eller skapare nycklar som är specifika för en betalningsleverantör.

Steg 3: Aktivera betalningsupplevelsen på ditt formulär. I det här steget inkluderar utvecklaren formuläret och aktiverar digitala betalningar i det nödvändiga steget för formuläret med flera steg.

Förutsättningar

• Registrera dig för ett konto med Stripe som betalningsleverantör och få testläget eller livenycklarna från betalningsappen installerade från Stripe Marketplace.
• Skapa eller identifiera en Microsoft Dataverse-tabell som du vill använda i ett flerstegsformulär. Den här tabellen måste ha en valutafältstyp som används för att debitera det belopp som du vill samla in från webbplatsanvändaren. Mer information finns i Så här skapar och ändrar du Dataverse-tabeller med hjälp av dataarbetsytan.
• Konfigurera ett formulär med flera steg med en Dataverse-tabell med ett steg som gör det möjligt för användare att betala. Det här steget visar betalningskontrollen när den har konfigurerats i ett senare steg.

Steg 1: installera paketet

1. I designstudion, välj Konfigurera.
2. Under Integreringar väljer du Externa appar.
3. Välj åtgärden Installera för Stripe.
4. När paketinstallationen är klar, starta om webbplatsen från Webbplatsåtgärder i administratörscentret.

Installationsåtgärden kan ta några minuter. Åtgärden ändras till Hantera när installationen är klar.

Steg 2: Konfigurera leverantören

När du har installerat paketet kan du börja konfigurera Stripe för Power Pages-webbplatsen.

Steg 2a: Skaffa dina Stripe-nycklar

1. I designstudion, välj Konfigurera.

2. Under Integreringar väljer du Externa appar.

3. I tabellen Integrationer väljer du åtgärden Hantera för Stripe.

4. Gå till Stripe Marketplace och installera Microsoft Power Pages Payments-appen.

5. När appen har installerats hämtar du de publicerbara och begränsade nycklar som krävs för att aktivera den här integreringen. Dessa värden behövs i senare steg.

   Obs

   • För den hemliga nyckeln rekommenderar vi att du använder begränsade API-nycklar som Stripe tillhandahåller för att begränsa åtkomst och behörigheter för olika delar av din kontodata i Stripe.
   • Version 9.6.3.x. lade till stöd för live-lägestangenter utöver testlägestangenter. För att förstå olika typer av nycklar, se Stripes dokumentation om API-nycklar.

Steg 2b: Välj din lagringstyp

Du kan använda Dataverse (stöder endast testläge) eller Azure Key Vault (stöder både testläge och live-läge) för att lagra Stripe API-nycklarna.

Om du väljer Dataverse fortsätter du till steg 2d (Lägg till dina nycklar i konfigurationen).

Om du använder Azure Key Vault lägger du till Stripe Begränsad-nyckeln som en hemlighet i ett nyckelvalv och tilldelar behörigheter till din webbplats genom att följa steg 2c (Konfigurera Azure Key Vault (valfritt)).

Steg 2c: Konfigurera Azure Key Vault (valfritt)

Om du väljer Azure Key Vault som lagringstyp utför du följande steg.

1. I Azure Portal hämtar du namnet på din app i Appregistreringar som motsvarar din Power Pages webbplats.

   Appens namn är detsamma som namnet på din webbplats med prefixet "Portals-". Om ditt webbplatsnamn är "Woodgrove Bank Applications" är appnamnet på Azure-portalen "Portals-Woodgrove Bank Applications". Anteckna det här appregistreringsnamnet för användning i följande steg.

   

2. Logga in på Azure Portal och gå till Key Vaults.

3. Skapa ett nytt nyckelvalv eller använd ett befintligt. När du skapar ett nytt nyckelvalv måste du välja en behörighetsmodell. Du kan välja antingen Azure rollbaserad åtkomstkontroll eller en Key Vault-åtkomstprincip. Om du vill se lämpliga steg väljer du fliken nedan baserat på ditt val av behörighetsmodell.

   • Azure rollbaserad åtkomstkontroll
   • Åtkomstprincip för nyckelvalvet

   1. Gå till ditt nyckelvalv i Azure Portal.
   2. Välj Åtkomstkontroll (IAM) i menyn på vänstra sidan.
   3. Välj + Lägg till högst upp på sidan och välj sedan Lägg till rolltilldelning.
   4. Under fliken Jobbfunktionsroller söker du efter rollnamnet Användare av nyckelvalvshemligheter, väljer det och väljer Nästa.
   5. För Tilldela åtkomst till, välj Användare, grupp eller tjänstens huvudnamn.
   6. Välj + Välj medlemmar och sök efter webbplatsens appregistreringsnamn enligt beskrivningen i början av steg 2c.
   7. Välj appen för din webbplats och välj Nästa.
   8. Välj Granska + tilldela.

   Din webbplats har nu behörighet att läsa hemligheter från det här nyckelvalvet.

4. Lägg till din Stripe-begränsade nyckel som en hemlighet i nyckelvalvet. Om du vill lära dig hur du skapar en hemlighet i Azure Key Vault går du till ställ in och hämta en hemlighet från Azure Key Vault med hjälp av Azure-portalen.

Steg 2d: Lägg till dina nycklar i konfigurationen

1. I designstudion anger du inställningarna på panelen Aktivera integrering.

   Om du använder Dataverse-lagringsalternativet anger du nycklarna Publicerbar och Hemlig.

   Om du använder Key Vault-lagringsalternativet anger du den publicerbara nyckeln, Azure Key Vault-namnet och det hemliga namnet.

2. Klicka på Spara och stäng panelen. Om du stöter på ett fel när du sparar kan du läsa felmeddelandet och lösa de problem som är relaterade till konfigurationen av nyckelvalvet.

3. Välj synkronisera.

Steg 3: Aktivera betalningsupplevelsen på ditt formulär

För att aktivera betalningar, slutför följande steg:

1. Skapa ett steg med flera steg i formuläret för Dataverse-tabellen som används i formulärprocessen där du vill ta emot betalningar.

2. Lägg till tabellbehörigheter för Dataverse tabeller som används i flerstegsformulärprocessen (du behöver minst behörighet för att Skapa och Skriva) och tilldela lämpliga webbroller.

3. Välj synkronisera.

4. I designstudion väljer du Sidor och navigerar till webbsidan där betalningsupplevelsen är avsedd.

5. Lägg till eller redigera flerstegsformuläret och skapa ett steg som heter Betala (eller liknande).

6. Fortsätt till Steginställningar.

   

   • Välj Appintegreringar.
   • Växla Aktivera digitala betalningar till på.
   • I fältet Välj belopp väljer du det valutatypsfält i tabellen som används för att debitera det belopp som du vill samla in från webbplatsanvändaren.  

   Kommentar

   Konfiguration av betalningsmetoder och fler inställningar kan göras direkt i Stripe. De kan kräva godkännande av andra villkor och konfiguration.

Betalningskontrollen läggs automatiskt till i formulärsteget som visar en förhandsvisning av betalningsmetoder aktiverade för att acceptera betalningar.

Förhandsgranska och testa webbsidan

I betalningssteget ska du kunna utföra en betalning med testkort som finns på Stripes webbplats.

En lyckad betalning visar bekräftelsen med det inbetalda beloppet och ett transaktions-ID som returnerats från betalningsleverantören.

Om det här steget är det sista steget i flerstegsformuläret aktiveras knappen Skicka som skickar formuläret och slutför processen.

Kontrollera betalningsfunktionen i en klientorganisation

En administratör kan inaktivera betalningar i en klientorganisation genom att ange klientorganisationsnivåinställningen disablePaymentIntegrationForPages via PowerShell.

Om du vill köra PowerShell-cmdlets måste du först installera de moduler som krävs.

Inaktivera betalningar

När du installerat modulerna, kör följande kommandon i ett PowerShell-fönster som administratör:

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

Administratörer är användare med någon av följande Azure-roller:

• Dynamics 365-administratör
• Power Platform-administratör

När betalningsfunktionen är inaktiverad i en klientorganisation:

• Skapare har följande upplevelse inom området Externa appar.

  

• Skapare har följande upplevelse på fliken Appintegreringar i en konfiguration med flerstegsformulär.

  

Varje upplevelse innehåller följande meddelande:

”Det här programmet har inaktiverats av din organisation. Kontakta administratören för att aktivera det.”

Aktivera betalningar

För att aktivera betalningsfunktionen i en klientorganisation, kör följande kommandon i ett PowerShell-fönster som administratör:

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

Att tänka på

• Betalningsvalutor och belopp. Minsta och högsta betalningsbeloppsvärden kan variera beroende på valutor. Läs Stripe-dokumentationen om valutor som stöds för att säkerställa att ditt formulär och tabeller är korrekt konfigurerade för att acceptera betalningar inom det intervallet.

• PCI DSS-efterlevnad (Payment Card Industry Data Security Standard). Den här funktionen använder betalningsintegreringsmetoden Stripe Web Elements och kortdata lagras inte i Power Pages eller Dataverse. PCI-efterlevnad är ett delat ansvar och gäller även för företag. Se Stripes dokumentation om validering av din PCI-kompatibilitet.

• Betalningstabell. För att lagra transaktioner finns en ny betalningstabell installerad med lösningen. Tabellen relateras automatiskt till den tabell som du väljer när du konfigurerar formulärstegen. Du kan använda tabellen för att se detaljer om transaktioner och status. Den här tabellen är bara en ögonblicksbild av information som tillhandahålls som du kan använda för att skapa andra upplevelser för dina företagsanvändare i Power Apps eller Power Pages. För mer information och felsökning av betalningsrelaterade problem bör du lita på betalningsleverantören, såsom Stripes instrumentpanel.

• Webhook. Betalningsfunktionen konfigurerar också en webhook på Stripe som används för att asynkront uppdatera statusen för betalningar som kan ta extra tid att slutföra.

  Kommentar

  När en webbplats är i privat läge kanske denna webhook inte kan kommunicera med Power Pages och därför kan du få e-postmeddelanden från Stripe. Detta är tillfälligt beteende och när din webbplats väl har växlats till offentligt läge bör webhooken kunna kommunicera framgångsrikt.