Konfigurer betalingsintegrering

Aktiver Power Pages-nettstedet ditt for å godta betalinger ved å bruke designstudioets konfigureringsarbeidsområde. Med denne integrasjonen uten kode kan du legge til en betalingskomponent i flertrinnsskjemaet ditt, slik at nettstedet ditt kan integreres med en betalingsleverandør.

Et skjermbilde av betalingsintegrasjonen på et Power Pages-nettsted.

For å godta betalinger på Power Pages-nettstedet ditt, må du fullføre disse trinnene:

Trinn 1: Installer pakken. I dette trinnet installerer områdeadministratoren pakken som består av nødvendige tabeller og andre forhåndskrav for miljøet for å aktivere betalingsopplevelsen.

Trinn 2: Konfigurer leverandør. I dette trinnet konfigurerer områdeadministratoren eller utvikleren nøklene som er spesifikke for en betalingsleverandør.

Trinn 3: Aktiver betalingsfunksjonen i skjemaet ditt. I dette trinnet tar utvikleren med skjemaet og aktiverer digitale betalinger i det obligatoriske trinnet for flertrinnsskjemaet.

Viktig!

Forutsetning

  • Registrer deg for en konto med Stripe som betalingsleverandør, og skaff deg testmodus eller livenøklene fra betalingsappen du installerer fra Stripe Marketplace.
  • Opprett eller identifiser en Microsoft Dataverse-tabell du vil bruke i et flertrinnsskjema. Denne tabellen må ha en valutafelttype som brukes til å belaste beløpet du ønsker å samle inn fra brukeren av nettstedet. Hvis du vil ha mer informasjon, kan du se Hvordan opprette og endre Dataverse-tabeller ved hjelp av dataarbeidsområdet.
  • Konfigurer et flertrinnsskjema ved hjelp av en Dataverse-tabell som har et trinn som lar brukere betale. Dette trinnet viser betalingskontrollen når den er konfigurert i et senere trinn.

Trinn 1: Installer pakken

  1. Velg Konfigurer i utformingsstudioet.
  2. Velg Eksterne apper under Integreringer.
  3. Velg handlingen Installer for Stripe.
  4. Når pakkeinstallasjonen er fullført, starter du nettstedet på nytt fra Handlinger for nettsted i administrasjonssenteret.

Installasjonshandlingen kan ta noen få minutter. Handlingen endres til administrer etter at installasjonen er fullført.

Trinn 2: Konfigurer leverandøren

Etter at du har installert pakken, kan du begynne å konfigurere Stripe for Power Pages-nettstedet.

Trinn 2a: Skaff deg Stripe-nøklene dine

  1. I designstudioet, velg Konfigurer.

  2. Velg Eksterne apper under Integreringer.

  3. Velg handlingen Administrer for Stripe i Integreringer-tabellen.

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

  5. Etter at appen er installert, skaffer du deg Publishable- og Restricted-nøklene du trenger for å kunne aktivere denne integreringen. Du trenger disse verdiene i senere trinn.

    Merk

    • For den hemmelige nøkkelen anbefaler vi å bruke begrensede API-nøkler som Stripe gir for å begrense tilgang og tillatelser for ulike områder av kontodataene dine i Stripe.
    • Versjon 9.6.3.x. fikk støtte for livemodusnøkler i tillegg til testmodusnøkler. For å forstå ulike typer nøkler kan du se Stripe-dokumentasjonen om API-nøkler.

Trinn 2b: Velg lagringstypen

Du kan bruke Dataverse (støtter bare testmodus) eller Azure Key Vault (støtter både testmodus og livemodus) til å lagre API-nøklene for Stripe.

Skjermbilde av panelet Aktiver integrering i arbeidsområdet for konfigurasjon i Power Pages-utformingsstudioet.

Hvis du velger Dataverse, går du videre til trinn 2d (Legg til nøklene i konfigurasjonen).

Hvis du bruker Azure Key Vault, legger du til Stripe Restricted-nøkkelen som en hemmelighet i et Key Vault og tilordner tillatelser til nettstedet ditt ved å følge trinn 2c (Konfigurer Azure Key Vault (valgfritt)).

Trinn 2c: Konfigurer Azure Key Vault (valgfritt)

Hvis du velger Azure Key Vault som lagringstype, følger du fremgangsmåten nedenfor.

  1. I Azure Portal henter du navnet på appen din i Appregistreringer som svarer til Power Pages-nettstedet ditt.

    Appnavnet er det samme som navnet på nettstedet ditt, med prefikset «Portals-». Hvis nettstedsnavnet er «Woodgrove Bank Applications», er appnavnet på Azure Portal «Portals-Woodgrove Bank Applications». Noter deg dette appregistreringsnavnet siden du skal bruke det i trinnene nedenfor.

    Skjermbilde av appregistreringen i Azure for et Power Pages-nettsted.

  2. Logg deg på Azure Portal, og gå til Key Vaults.

  3. Opprett et nytt Key Vault eller bruk et eksisterende. Når du oppretter et nytt Key Vault, må du velge en tillatelsesmodell. Du kan velge Azure-rollebasert tilgangskontroll eller en tilgangspolicy for Key Vault. For å se de riktige trinnene velger du fanen nedenfor basert på valget av tillatelsesmodell.

    1. Naviger til ditt Key Vault i Azure Portal.
    2. Velg Tilgangskontroll (IAM) på menyen til venstre.
    3. Velg + Legg til øverst på siden, og velg deretter Legg til rolletilordning.
    4. Søk etter rollenavnet Bruker av Key Vault-hemmeligheter i fanen Jobbfunksjonsroller, velg det, og velg deretter Neste.
    5. For Tilordne tilgang til velger du Bruker, gruppe eller tjenestekontohaver.
    6. Velg + Velg medlemmer, og søk etter appregistreringsnavnet for nettstedet ditt, som beskrevet i begynnelsen av trinn 2c.
    7. Velg appen for nettstedet, og velg Neste.
    8. Velg Se gjennom + tildel.

    Nettstedet ditt har nå tillatelse til å lese hemmeligheter fra dette Key Vault.

  4. Legg til Stripe Restricted-nøkkelen som en hemmelighet i Key Vault. Hvis du vil vite hvordan du oppretter en hemmelighet i Azure Key Vault, kan du gå til Angi og hente en hemmelighet fra Azure Key Vault ved hjelp av Azure Portal.

Trinn 2d: Legg til nøklene i konfigurasjonen

  1. I utformingsstudioet angir du innstillingene i panelet Aktiver integrering.

    Hvis du bruker lagringsalternativet Dataverse, angir du nøklene Publishable og Secret.

    Hvis du bruker lagringsalternativet Key Vault, angir du Publishable-nøkkelen, Azure Key Vault-navnet og Secret-navnet.

  2. Velg Lagre, og lukk panelet. Hvis det oppstår en feil under lagringen, kan du se feilmeldingen og løse problemene knyttet til konfigurasjon av Key Vault.

  3. Velg Synkroniser.

Trinn 3: Aktiver betalingsopplevelsen på skjemaet ditt

Du aktiverer betalinger ved å fullføre følgende trinn:

  1. Opprett et flertrinnsskjematrinn for Dataverse-tabellen som brukes i flertrinnsskjemaprosessen, der du ønsker å godta betalinger.

  2. Legg til tabelltillatelser for Dataverse-tabeller som brukes i flertrinnsskjemaprosessen (du må minst ha tillatelsene Opprette og Skrive), og tilordne aktuelle nettroller.

  3. Velg Synkroniser.

  4. Velg Sider i utformingsstudioet, og gå til nettsiden der du har tenkt å bure betalingsfunksjonen.

  5. Legg til eller rediger flertrinnsskjema, og lag et trinn kalt Betale (eller liknende).

  6. Gå videre til Trinninnstillinger.

    Skjermbilde av alternativene for Trinninnstillinger i arbeidsområdet Sider i Power Pages-utformingsstudioet.

    • Velg Appintegreringer.
    • Aktiver Aktiver digitale betalinger.
    • I Velg beløpsfeltet velger du valutatypefeltet i tabellen som brukes til å belaste beløpet du vil samle inn fra nettstedsbrukeren.  

    Merk

    Konfigurasjon av betalingsmetoder og flere innstillinger kan gjøres direkte i Stripe. De kan kreve aksept av andre vilkår og konfigurasjon.

Betalingskontrollen legges automatisk til i skjematrinnet som viser en forhåndsvisning av betalingsmåter som er aktivert for å godta betalinger.

Forhåndsvis og test nettsiden

På Betal-trinnet skal du kunne utføre en betaling ved hjelp av testkort som er tilgjengelige på Stripes-nettsiden.

En vellykket betaling viser bekreftelsen med det betalte beløpet og en transaksjons-ID returnert fra betalingsleverandøren.

Merk

Du må deaktivere tilbakeknappen fra trinninnstillingene hvis du ikke vil la brukere gå til forrige trinn fra betalingstrinnet.

Hvis dette trinnet er siste trinn i flertrinnsskjemaet, aktiveres en innsendingsknapp som brukes til å sende inn skjemaet og fullføre prosessen.

Styr betalingsfunksjonen i en leier

En administrator kan deaktivere betalinger i en leier ved å angi innstillingen disablePaymentIntegrationForPages på leiernivå via PowerShell.

Hvis du vil kjøre PowerShell-cmdleter, må du først installere de påkrevde modulene.

Deaktiver betalinger

Etter at du har installert modulene, kjører du følgende kommando i et PowerShell-vindu som en administrator:

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

Administratorer er brukerne som har en av følgende Azure-roller:

Etter at betalingsfunksjonen er deaktivert i en leier:

  • Utviklere har følgende funksjonen i området Eksterne apper.

    Skjermbilde av panelet Aktiver integrering der integrering av Stripe-betaling vises som blokkert.

  • Utviklere har følgende funksjon i fanen Appintegreringer i en konfigurasjon for flertrinnsskjema.

    Skjermbilde av fanen Appintegreringer i et flertrinnsskjema.

Hver funksjon omfatter følgende melding:

«Dette programmet er deaktivert av organisasjonen din. Kontakt administratoren for å aktivere den.»

Merk

Etter at Alle er angitt for denne leierinnstillingen, forhindrer den at betalingsfunksjonen konfigureres for flere nettsteder senere. Den påvirker ikke konfigurasjon og betalingsoppsett i skjemaer som allerede kan ha blitt fullført av utviklere i miljøene deres.

Aktiver betalinger

Du kan aktivere betalingsfunksjonen i en leier ved å kjøre følgende kommando i et PowerShell-vindu som administrator:

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

Vurderinger

  • Betalingsvalutaer og beløp. Minimums- og maksimumsverdier for betalingsbeløp kan variere etter valuta. Se gjennom Stripe-dokumentasjonen om støttede valutaer for å sikre at skjemaet og tabellene er riktig konfigurert for å godta betalinger i dette området.

  • Samsvar med datasikkerhetsstandarden for betalingskortindustrien (PCI DSS) Denne funksjonen bruker tilnærmingen Stripe Web Elements for betalingsintegrering, og kortdata lagres ikke i Power Pages eller Dataverse. PCI-samsvar er et delt ansvar og gjelder forretning også. Se Stripe-dokumentasjonen om validering av PCI-forskriftssamsvar.

  • Betalingstabell. Når det gjelder lagring av transaksjoner, installeres en ny betalingstabell med løsningen. Tabellen er automatisk relatert til tabellen du velger når du konfigurerer skjematrinnene. Du kan bruke tabellen til å se detaljene for transaksjoner og status. Denne tabellen er bare et øyeblikksbilde av informasjon som er gitt, som du kan bruke til å skape andre opplevelser for bedriftsbrukere i Power Apps eller Power Pages. Hvis du vil ha mer informasjon og feilsøke betalingsrelaterte problemer, bruker du betalingsleverandøren, for eksempel Stripe-instrumentbordet.

  • Webhook. Betalingsfunksjonen konfigurerer også en webhook på Stripe som brukes til asynkron oppdatering av statusen for betalinger som kan ta ekstra tid å fullføre.

    Merk

    Når et nettsted er i privat modus, kan det hende at denne webhook ikke kan kommunisere med Power Pages og derfor kan du motta e-post fra Stripe. Dette er uregelmessig oppførsel, og når nettstedet ditt er byttet til offentlig modus, skal webhook-en kunne kommunisere vellykket.