Del via

Opsætte integration af betalinger

Gør dit Power Pages-websted i stand til at acceptere betalinger ved at bruge området Opsætning i designstudiet. Med denne kodefri integration kan du føje en betalingskomponent til din formular med flere trin, så din hjemmeside kan integreres med en betalingsudbyder.

Et skærmbillede af betalingsintegrationen på et Power Pages-websted.

For at acceptere betalinger på dit Power Pages-websted skal du udføre disse trin:

Trin 1: Installer pakken. I dette trin installerer webstedsadministratoren pakken, der består af påkrævede tabeller og andre forudsætninger, for at miljøet kan muliggøre betalingsoplevelsen.

Trin 2: Konfigurer udbyder. I dette trin konfigurerer webstedsadministratoren eller udvikleren nøgler, der er specifikke for en betalingsudbyder.

Trin 3: Aktivér betalingsoplevelsen i din formular. I dette trin inkluderer udvikleren formularen og aktiverer digitale betalinger på det påkrævede trin til formularen med flere trin.

Vigtigt!

Forudsætninger

  • Tilmeld dig en konto hos Stripe som din betalingsudbyder, og få testtilstand eller livenøglerne fra betalingsappen, der er installeret fra Stripe Marketplace.
  • Opret eller identificer en Microsoft Dataverse-tabel, du vil bruge i en formular med flere trin. Denne tabel skal have en valutafelttype, der bruges til at opkræve det beløb, du ønsker at opkræve fra webstedsbrugeren. Du kan få flere oplysninger i Sådan opretter og redigerer du Dataverse-tabeller med arbejdsområdet Data.
  • Konfigurer en formular med flere trin med en Dataverse-tabel med et trin, hvor brugerne kan betale. Dette trin viser betalingskontrolelementet, når det er konfigureret i et senere trin.

Trin 1: Installer pakken

  1. Vælg Konfigurer i designstudiet.
  2. Under Integrationer skal du vælge Eksterne apps.
  3. Vælg handlingen Installer for Stripe.
  4. Når pakkeinstallationen er fuldført, skal du genstarte webstedet fra Webstedshandlinger i Administration.

Installationshandlingen tager muligvis et par minutter. Handlingen ændres til administration, når installationen er fuldført.

Trin 2: Konfigurer udbyderen

Når du har installeret pakken, kan du begynde at konfigurere Stripe til Power Pages-webstedet.

Trin 2a: Få dine Stripe-nøgler

  1. Vælg Konfigurer i Design studio.

  2. Under Integrationer skal du vælge Eksterne apps.

  3. I tabellen Integrationer skal du vælge handlingen Administrer for Stripe.

  4. Gå til Stripe Marketplace, og installer Microsoft Power Pages-appen Betalinger.

  5. Når appen er installeret, skal du hente de nøgler, der kan publiceres, og de begrænsede nøgler, der kræves for at aktivere denne integration. Disse værdier skal bruges i de senere trin.

    Bemærk

    • Til den hemmelige nøgle anbefaler vi at bruge begrænsede API-nøgler, som Stripe leverer, for at begrænse adgang og tilladelser til forskellige områder af dine kontodata i Stripe.
    • Version 9.6.3.x. tilføjede understøttelse af nøgler i livetilstand ud over nøgler i testtilstand. For at forstå forskellige typer nøgler kan du se Stripes dokumentation om API-nøgler.

Trin 2b: Vælg din lagertype

Du kan bruge Dataverse (understøtter kun testtilstand) eller Azure Key Vault (understøtter både testtilstand og livetilstand) til at gemme API-nøglerne for Stripe.

Skærmbillede af panelet Aktivér integration i arbejdsområdet Konfigurer i Power Pages-designstudiet.

Hvis du vælger Dataverse, skal du fortsætte til trin 2d (Føj dine nøgler til din konfiguration).

Hvis du bruger Azure Key Vault, skal du tilføje den begrænsede Stripe-nøgle som en hemmelighed i en Key Vault og tildele tilladelser til dit websted ved at følge trin 2c (Konfigurer Azure Key Vault (valgfrit)).

Trin 2c: Konfigurer Azure Key Vault (valgfrit)

Hvis du vælger Azure Key Vault som lagertype, skal du udføre følgende trin.

  1. På Azure-portalen skal du hente navnet på din app i Appregistreringer, som svarer til dit Power Pages-websted.

    Appnavnet er det samme som navnet på dit websted med præfikset "Portals-". Hvis dit webstedsnavn er "Woodgrove Bank Applications", er appnavnet på Azure-portalen "Portals-Woodgrove Bank Applications". Notér dette appregistreringsnavn til brug i følgende trin.

    Skærmbillede af appregistreringen i Azure for et Power Pages-websted.

  2. Log på Azure-portalen, og naviger til Key Vaults.

  3. Opret en ny key vault, eller brug en eksisterende. Når du opretter en ny Key Vault, skal du vælge en tilladelsesmodel. Vælg enten Azure rollebaseret adgangskontrol eller Key Vault-adgangspolitik. Hvis du vil se de relevante trin, skal du vælge fanen nedenfor baseret på dit valg af tilladelsesmodel.

    1. Naviger til din key vault i Azure-portalen.
    2. Vælg Adgangskontrol (IAM) i menuen til venstre.
    3. Vælg + Tilføj øverst på siden, og vælg derefter Tilføj rolletildeling.
    4. Under fanen Jobfunktionsroller skal du søge efter navnet på brugerrollen Key Vault-hemmeligheder, vælge det og derefter vælge Næste.
    5. For Tildel adgang til skal du vælge Bruger, gruppe eller tjenestekonto.
    6. Vælg + Vælg medlemmer, og søg efter navnet på din websteds appregistrering som beskrevet i begyndelsen af trin 2c.
    7. Vælg appen for dit websted, og vælg Næste.
    8. Vælg Gennemgå + tildel.

    Dit websted har nu tilladelser til at læse hemmeligheder fra denne key vault.

  4. Føj din begrænsede Stripe-nøgle som en hemmelighed til key vault. Du kan få mere at vide om, hvordan du opretter en hemmelighed i Azure Key Vault, ved at gå til Angiv og hent en hemmelighed fra Azure Key Vault ved hjælp af Azure-portalen.

Trin 2d: Føj dine nøgler til din konfiguration

  1. Angiv indstillingerne i panelet Aktivér integration i designstudiet.

    Hvis du bruger Dataverse-agringsindstillingen, skal du angive de nøgler, der kan publiceres, og de hemmelige nøgler.

    Hvis du bruger indstillingen Key Vault-lager, skal du angive den nøgle, der kan publiceres, navnet på Azure Key Vault og navnet på hemmeligheden.

  2. Vælg Gem, luk panelet. Hvis der opstår en fejl under lagring, skal du se fejlmeddelelsen og løse de problemer, der er relateret til konfigurationen af Key Vault.

  3. Vælg Synkroniser.

Trin 3: Aktivér betalingsoplevelsen i din formular

Fuldfør følgende trin for at aktivere betalinger:

  1. Opret et trin for en formular med flere trin til den Dataverse-tabel, der bruges i formularprocessen med flere trin, hvor du vil acceptere betalinger.

  2. Tilføj tabeltilladelser til de Dataverse-tabeller, der bruges i formularprocessen med flere trin (du skal som minimum have tilladelserne Opret og Skriv), og tildel de relevante webroller.

  3. Vælg Synkroniser.

  4. Vælg Sider i designstudiet, og naviger til den webside, hvor betalingsoplevelsen er tilsigtet.

  5. Tilføj eller rediger formularen med flere trin, og opret et trin kaldet Betal (eller lignende).

  6. Gå til Indstillinger for trin.

    Skærmbillede af indstillingsmulighederne for trin i arbejdsområdet Sider i Power Pages-designstudiet.

    • Vælg Appintegrationer.
    • Slå Aktivér digitale betalinger til.
    • I Vælg beløbsfelt skal du vælge feltet Valutatype i den tabel, der bruges til at opkræve det beløb, du vil opkræve fra webstedsbrugeren.  

    Bemærk

    Konfiguration af betalingsmetoder og flere indstillinger kan foretages direkte i Stripe. De kræver muligvis, at du accepterer andre vilkår og udfører konfiguration.

Betalingskontrolelementet føjes automatisk til formulartrinnet, der viser en forhåndsvisning af betalingsmetoder, der er aktiveret til at acceptere betalinger.

Gennemse og test websiden

På betalingstrinnet skal du kunne udføre en betaling ved hjælp af testkort, der er tilgængelige på Stripes websted.

En vellykket betaling viser bekræftelsen med det betalte beløb og et transaktions-id, der returneres fra betalingsudbyderen.

Bemærk

Du skal deaktivere Tilbage-knappen fra trinindstillingerne, hvis du ikke vil tillade, at brugere går til det forrige trin fra betalingstrinnet.

Hvis dette trin er det sidste trin i formularen med flere trin, aktiveres knappen Send, som sender formularen og fuldfører processen.

Funktion til kontrol af betaling i en lejer

En administrator kan deaktivere betalinger i en lejer ved at angive indstillingen disablePaymentIntegrationForPages på lejerniveau via PowerShell.

Hvis du vil køre PowerShell-cmdletter, skal du først installere de påkrævede moduler.

Deaktiver betalinger

Når modulerne er installeret, skal du køre følgende kommando i et PowerShell-vindue som administrator.

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

Administratorer er de brugere, der har en af følgende Azure-roller:

Når betalingsfunktionen er deaktiveret i en lejer:

  • Udviklere har følgende oplevelse i området Eksterne apps.

    Skærmbillede af panelet Aktivér integration med Stripe-betalinger vist som blokeret.

  • Udviklere har følgende oplevelse under fanen Appintegrationer i konfigurationen af en formular med flere trin.

    Skærmbillede af fanen Appintegrationer i en formular med flere trin.

Hver oplevelse indeholder følgende meddelelse:

"Denne applikation er blevet deaktiveret af din organisation. Kontakt administratoren for at aktivere det."

Bemærk

Når denne lejerindstilling er angivet til Alle, forhindrer det fremover konfigurationen af betalingsmuligheder for flere websteder. Det påvirker ikke konfigurationen og betalingskonfigurationen af formularer, der allerede er udfyldt af udviklere i deres miljøer.

Aktivér betalinger

Hvis du vil aktivere betalingsfunktionen i en lejer, skal du køre følgende kommando i et PowerShell-vindue som administrator:

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

Overvejelser

  • Betalingsvalutaer og -beløb. Værdierne for minimum- og maksimumbetalingsbeløb kan variere afhængigt af valutaer. Gennemgå Stripe-dokumentationen om understøttede valutaer for at sikre, at din formular og dine tabeller er konfigureret korrekt til at acceptere betalinger i det pågældende interval.

  • Overholdelse af Payment Card Industry Data Security Standard (PCI DSS). Denne funktion bruger betalingsintegrationsmetoden Stripe Web Elements, og kortdata gemmes ikke i Power Pages eller Dataverse. PCI-overholdelse er et delt ansvar og gælder også for virksomheder. Se Stripes dokumentation om validering af din PCI-overholdelse.

  • Betalingstabel. Med henblik på lagring af transaktioner installeres der en ny betalingstabel sammen med løsningen. Tabellen er automatisk relateret til den tabel, du vælger, når du konfigurerer formulartrinnene. Du kan bruge tabellen til at se detaljerne om transaktioner og status. Denne tabel er bare et snapshot af leverede oplysninger, som du kan bruge til at skabe andre oplevelser for dine forretningsbrugere i Power Apps eller Power Pages. Du kan finde flere oplysninger om og fejlfinding af betalingsrelaterede problemer gennem betalingsudbyderen, f.eks. Stripes dashboard.

  • Webhook. Betalingsfunktionen konfigurerer også en webhook på Stripe, der bruges til asynkron opdatering af status for betalinger, der kan tage ekstra lang tid at fuldføre.

    Bemærk

    Når et websted er i privat tilstand, er denne webhook muligvis ikke i stand til at kommunikere med Power Pages, og du kan derfor modtage mails fra Stripe. Dette er en midlertidig funktionsmåde, og når først dit websted er skiftet til offentlig tilstand, bør webhook'et være i stand til at kommunikere.