Maksujen integraation määrittäminen

Salli Power Pages -sivustosi vastaanottaa maksuja Design Studion Set up -työtilan avulla. Tämän koodittoman integroinnin avulla voit lisätä maksukomponentin monivaiheiseen lomakkeeseen, mikä mahdollistaa verkkosivustosi integroinnin maksupalveluntarjoajan kanssa.

Hyväksyäksesi maksut Power Pages -sivustollasi sinun on suoritettava nämä vaiheet:

Vaihe 1: Paketin asentaminen. Tässä vaiheessa sivuston järjestelmänvalvoja asentaa paketin, joka koostuu ympäristön pakollisista taulukoista ja muista esivaatimuksista maksukokemuksen käyttöön ottamista varten.

Vaihe 2: Palveluntarjoajan määrittäminen. Tässä vaiheessa sivuston järjestelmänvalvoja tai luoja määrittää palveluntarjoajakohtaiset avaimet.

Vaihe 3: Ota maksukokemus käyttöön lomakkeellasi. Tässä vaiheessa tekijä sisällyttää lomakkeen ja ottaa sähköiset maksut käyttöön sopivassa monivaiheisen lomakkeen vaiheessa.

Tärkeää

• Tämä ominaisuus toimii vain parannetun tietomallin kanssa.
• Tämä ominaisuus vaatii Power Pages -verkkosivuston koontiversion 9.5.10.x, jotta maksujen hallinta näkyy sivustolla.

edellytykset

• Rekisteröi tili määrittäen Stripen maksupalveluntarjoajaksi ja hanki testitila tai live-avaimet Stripe Marketplacesta asennetusta maksusovelluksesta.
• Luo tai määritä Microsoft Dataverse -taulukko, jota haluat käyttää monivaiheisessa lomakkeessa. Tässä taulukossa on oltava valuuttakenttätyyppi, jota käytetään veloittamaan summa, jonka haluat kerätä sivuston käyttäjältä. Lisätietoja on kohdassa Dataverse -taulukoiden luominen ja muokkaaminen tietotyötilan avulla.
• Määritä monivaiheinen lomake, joka käyttää Dataverse-taulukkoa ja jossa on maksuvaihe käyttäjille. Tämä vaihe näyttää maksujen hallinnan, kun se on määritetty myöhemmässä vaiheessa.

Vaihe 1: Paketin asentaminen

1. Valitse suunnittelustudiossa Määritys.
2. Valitse Integroinnit-kohdassa Ulkoiset sovellukset.
3. Valitse Asenna-toiminto Stripelle.
4. Kun paketin asennus on valmis, käynnistä verkkosivusto uudelleen kohdasta Sivuston toiminnot hallintakeskuksessa.

Asennustoiminto voi kestää muutaman minuutin. Toiminnoksi muuttuu Hallinta, kun asennus on valmis.

Vaihe 2: Palveluntarjoajan määrittäminen

Kun olet asentanut paketin, voit alkaa määrittää Stripea Power Pages -sivustoa varten.

Vaihe 2a: Hanki Stripe-avaimet

1. Valitse suunnittelustudiossa Määritä.

2. Valitse Integroinnit-kohdassa Ulkoiset sovellukset.

3. Valitse Integroinnit-taulukosta Stripen Hallinta-toiminto.

4. Siirry Stripe Marketplaceen ja asenna Microsoft Power Pages Payments -sovellus.

5. Kun sovellus on asennettu, hanki integroinnin käyttöönottoon tarvittavat Publishable- ja Restricted-avaimet. Näitä arvoja tarvitaan myöhemmissä vaiheissa.

   Muistiinpano

   • Suosittelemme salaiseksi avaimeksi rajoitetut API-avaimet -toiminnon käyttöä jonka Stripe tarjoaa rajoittaakseen pääsyä ja käyttöoikeuksia tilitietojesi eri osiin Stripessä.
   • Julkaisussa 9.6.3.x lisättiin tuki reaaliaikaisen tilan avaimille testitilan avainten lisäksi. Jos haluat ymmärtää eri avaintyyppejä, katso Stripen dokumentaatio API-avaimista.

Vaihe 2b: Valitse tallennustyyppi

Voit käyttää Dataversea (tukee vain testitilaa) tai Azure Key Vaultia (tukee sekä testitilaa että live-tilaa) Stripe API -avainten tallentamiseen.

Jos valitset Dataversen, jatka vaiheeseen 2d (Avainten lisääminen määritykseen).

Jos käytät Azure Key Vaultia, lisää Stripe Restricted -avain avaimen salaisuutena avainsäilöön ja määritä sivustosi käyttöoikeudet noudattamalla vaihetta 2c (Määritä Azure Key Vault (valinnainen)).

Vaihe 2c: Määritä Azure Key Vault (valinnainen)

Jos valitset tallennustyypiksi Azure Key Vault, toimi seuraavasti.

1. Hae Azure-portaalissa sovelluksesi nimi kohdasta Sovelluksen rekisteröinnit, joka vastaa Power Pages -verkkosivustoasi.

   Sovelluksen nimi on sama kuin verkkosivustosi nimi, jonka etuliite on "Portals-". Jos sivustosi nimi on "Woodgrove Bank Applications", sovelluksen nimi Azure-portaalissa on "Portals-Woodgrove Bank Applications". Kirjoita tämä sovelluksen rekisteröintinimi muistiin, jotta voit käyttää sitä seuraavissa vaiheissa.

   

2. Kirjaudu Azure-portaaliin ja siirry kohtaan Key Vaults.

3. Uuden avainsäilön luominen tai aiemmin luodun käyttäminen. Kun luot uutta avainsäilöä, sinun on valittava käyttöoikeusmalli. Voit valita joko Azuren roolipohjainen käytönvalvonta tai Key Vaultin käyttökäytäntö. Jos haluat nähdä tarvittavat vaiheet, valitse alla oleva välilehti valitsemasi käyttöoikeusmallin perusteella.

   Azuren roolipohjainen käyttöoikeuksien valvonta

   1. Siirry Azure-portaalissa avainsäilöösi.
   2. Valitse vasemman reunan valikosta Käytön valvonta (IAM).
   3. Valitse sivun yläreunassa + Lisää ja valitse sitten Lisää roolimääritys.
   4. Etsi Työtehtävän roolit -välilehdessä Key Vaultin salaisuuksien käyttäjä -roolin nimi, valitse se ja valitse sitten Seuraava.
   5. Valitse Käyttöoikeuden delegointi -kohdassa Käyttäjä, ryhmä tai palvelun pääobjekti.
   6. Valitse + Valitse jäsenet ja hae sivustosi sovellusrekisteröintinimeä vaiheen 2c alussa kuvatulla tavalla.
   7. Valitse sovellus sivustollesi ja sitten Seuraava.
   8. Valitse Tarkista + määritä.

   Key Vaultin käyttöoikeuskäytäntö

   1. Valitse vasemman reunan valikosta Käyttöoikeuskäytännöt.
   2. Valitse sivun yläosasta + Luo.
   3. Valitse Salaisuuksien käyttöoikeudet -kohdassa Hae>Seuraava.
   4. Hae sivustosi sovellusrekisteröintinimeä vaiheen 2c alussa kuvatulla tavalla.
   5. Valitse sivustolle sovellus ja sitten Seuraava.
   6. Valitse Luo.

   Sivustollasi on nyt oikeudet lukea salaisuuksia tästä avainsäilöstä.

4. Lisää Stripen Restricted-avain salaisuudeksi avainsäilöön. Lisätietoja salaisuuden luomisesta Azure Key Vaultissa on kohdassa Aseta ja hae salaisuus Azure Key Vaultista Azure-portaalin avulla.

Vaihe 2d: Lisää avaimet määritykseen

1. Määritä asetukset suunnittelustudion Ota integrointi käyttöön -paneelissa.

   Jos käytät Dataverse-tallennusvaihtoehtoa, anna Publishable- ja Secret-avaimet.

   Jos käytät Key Vault -tallennusvaihtoehtoa, määritä Publishable-avain, Azure-avainsäilön nimi ja salaisuuden nimi.

2. Valitse Tallenna ja sulje paneeli. Jos tallennuksen aikana ilmenee virhe, katso virheilmoitus ja ratkaise avainsäilön määrityksiin liittyvät ongelmat.

3. Valitse Synkronoi.

Vaihe 3: Ota maksukokemus käyttöön lomakkeellasi

Ota maksut käyttöön noudattamalla seuraavia vaiheita:

1. Luo monivaiheisen lomakkeen vaihe sille monivaiheisen lomakkeen prosessissa käytettävälle Dataverse-taulukolle, jossa haluat hyväksyä maksuja.

2. Lisää taulukon käyttöoikeudet Dataverse-taulukoille, joita käytetään monivaiheisen lomakkeen prosessissa (tarvitset vähintään oikeudet Luo ja Kirjoita) ja määritä soveltuvat verkkoroolit.

3. Valitse Synkronoi.

4. Valitse suunnittelustudiossa Sivut ja siirry verkkosivulle, johon maksukokemus on tarkoitettu.

5. Lisää monivaiheinen lomake tai muokkaa sitä ja luo vaihe nimeltä Maksa (tai vastaava).

6. Siirry kohtaan Vaiheiden asetukset.

   

   • Valitse Sovellusintegroinnit.
   • Määritä Ota digitaaliset maksut käyttöön -asetus käyttöön.
   • Valitse Valitse summakenttä -kohdassa taulukon valuuttatyyppikenttä, jota käytetään sivuston käyttäjältä kerättävän summan veloittamiseen.  

   Muistiinpano

   Maksutapojen konfigurointi ja muut asetukset voidaan tehdä suoraan Stripessä. Ne saattavat edellyttää muiden ehtojen ja määritysten hyväksymistä.

Maksunhallinta lisätään automaattisesti lomakkeen vaiheeseen, joka näyttää esikatselun maksutavoista, jotka on otettu käyttöön maksujen hyväksymiseen.

Esikatsele verkkosivua ja testaa sitä

Maksa-vaiheessa sinun pitäisi pystyä suorittamaan maksu käyttämällä Stripen verkkosivuilta saatavia testikortteja.

Onnistuneen maksun yhteydessä näkyy vahvistus, jossa on maksettu summa ja maksupalveluntarjoajalta palautettu tapahtumatunnus.

Muistiinpano

Poista Takaisin-painike käytöstä vaiheasetuksista, jos et halua sallia käyttäjien siirtyä edelliseen vaiheeseen maksuvaiheesta.

Jos tämä vaihe on monivaiheisen lomakkeen viimeinen vaihe, käytössä on Lähetä-painike, joka lähettää lomakkeen ja viimeistelee prosessin.

Maksuominaisuuden hallinta vuokraajassa

Järjestelmänvalvoja voi poistaa vuokraajassa maksut käytöstä määrittämällä vuokraajatason disablePaymentIntegrationForPages-asetuksen PowerShellin kautta.

Jotta voit suorittaa PowerShell-cmdlet-komentosovelmat, sinun täytyy ensin asentaa vaaditut moduulit.

Poista maksut käytöstä

Suorita moduulien asentamisen jälkeen seuraava komento PowerShell-ikkunassa järjestelmänvalvojana:

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

Järjestelmänvalvojat ovat käyttäjiä, joilla on jokin seuraavista Azure-rooleista:

• Dynamics 365 -järjestelmänvalvoja
• Power Platform -järjestelmänvalvoja

Kun maksutoiminto on poistettu käytöstä vuokraajassa:

• Tekijöillä on seuraava kokemus Ulkoiset sovellukset -alueella.

  

• Tekijöillä on seuraava kokemus monivaiheisen lomakemäärityksen Sovellusintegroinnit-välilehdessä.

  

Jokaisessa kokemuksessa on seuraava viesti:

"Organisaatiosi on poistanut tämän sovelluksen käytöstä. Pyydä järjestelmänvalvojaa ottamaan se käyttöön."

Muistiinpano

Kun vuokraaja-asetukseksi on määritetty Kaikki, se estää maksuominaisuuden määrittämisen muille sivustoille. Se ei vaikuta määrityksiin tai maksuasetuksiin lomakkeissa, jotka tekijät ovat ehkä jo viimeistelleet ympäristöissään.

Ota maksut käyttöön

Voit ottaa maksuominaisuuden käyttöön vuokraajassa suorittamalla seuraava komento PowerShell-ikkunassa järjestelmänvalvojana:

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

Huomioitavia seikkoja

• Maksuvaluutat ja -summat. Maksun vähimmäis- ja enimmäissummat voivat vaihdella valuutoista riippuen. Tarkista Stripe-dokumentaatio tuetuista valuutoista varmistaaksesi, että lomakkeesi ja taulukosi on määritetty oikein hyväksymään maksuja kyseisellä alueella.

• Payment Card Industry Data Security Standard (PCI DSS) -yhteensopivuus. Tämä ominaisuus käyttää Stripe Web Elements -maksuintegrointimenetelmää, eikä korttitietoja tallenneta Power Pagesiin tai Dataverseen. PCI-vaatimustenmukaisuus on jaettu vastuu ja koskee myös liiketoimintaa. Katso Stripen dokumentaatio kohdasta PCI-yhteensopivuuden vahvistaminen.

• Maksutaulukko. Tapahtumien tallentamista varten ratkaisun mukana on asennettu uusi maksutaulukko. Taulukko liittyy automaattisesti taulukkoon, jonka valitset määrittäessäsi lomakkeen vaiheita. Taulukon avulla voit tarkastella tapahtumien ja tilan tietoja. Tämä taulukko on vain tilannekuva tiedoista, joita voit käyttää luomaan muita kokemuksia yrityskäyttäjillesi Power Appsissa tai Power Pagesissa. Lisätietoja ja maksuihin liittyvien ongelmien vianmääritystä varten sinun tulee luottaa maksupalveluntarjoajaan, kuten Stripen koontinäyttöön.

• Webhook. Maksuominaisuus määrittää myös Stripen webhookin, jota käytetään asynkronisesti päivittämään sellaisten maksujen tilaa, joiden suorittaminen saattaa viedä ylimääräistä aikaa.

  Muistiinpano

  Kun verkkosivusto on yksityisessä tilassa, tämä webhook ei ehkä pysty kommunikoimaan Power Pagesin kanssa ja siksi saatat saada sähköposteja Stripeltä. Tämä on ajoittaista toimintaa, ja kun verkkosivustosi on vaihdettu julkiseen tilaan, webhookin pitäisi pystyä viestimään onnistuneesti.