Konfigurowanie integracji płatności

Włącz swoją witrynę Power Pages, aby akceptowała płatności, korzystając z obszaru roboczego Konfiguracja w studio projektowym. Dzięki tej integracji bez kodu możesz dodać komponent płatności do swojego wieloetapowego formularza, umożliwiając integrację swojej witryny z dostawcą usług płatniczych.

Aby akceptować płatności w swojej witrynie Power Pages, musisz wykonać następujące kroki:

Krok 1: Instalowanie pakietu. W tym kroku administrator witryny instaluje pakiet składający się z wymaganych tabel i innych wymagań wstępnych dotyczących środowiska, aby umożliwić płatności.

Krok 2: Konfigurowanie dostawcy. Na tym etapie administrator lub twórca witryny konfiguruje klucze specyficzne dla dostawcy usług płatniczych.

Krok 3: Włączanie obsługi płatności w formularzu. W tym kroku twórca dołącza formularz i włącza płatności cyfrowe na wymaganym etapie dla formularza wieloetapowego.

Ważne

• Ta funkcja działa tylko z rozszerzonym modelem danych.
• Ta funkcja wymaga wersji kompilacji witryny internetowej Power Pages 9.5.10.x, aby kontrola płatności była wyświetlana w witrynie.

Wymagania wstępne

• Zarejestruj konto w Stripe jako dostawcy płatności i uzyskaj tryb testowy lub klucze rzeczywiste z aplikacji płatności zainstalowanej z Stripe Marketplace.
• Utwórz lub zidentyfikuj tabelę Microsoft Dataverse, której chcesz użyć w formularzu wieloetapowym. Ta tabela musi mieć pole typu waluta, które jest używane do naliczania kwoty, którą chcesz pobrać od użytkownika witryny. Aby uzyskać więcej informacji, zobacz Jak tworzyć i modyfikować tabele Dataverse przy użyciu obszaru roboczego Data.
• Skonfiguruj formularz wieloetapowy, używając tabeli Dataverse z etapem umożliwiającym użytkownikom płacenie. W tym kroku wyświetlana jest kontrola płatności skonfigurowana w późniejszym kroku.

Krok 1: Instalowanie pakietu

1. W studio projektowania wybierz opcję Konfiguracja.
2. W sekcji Integracje wybierz Aplikacje zewnętrzne.
3. Wybierz akcję Zainstaluj dla Stripe.
4. Po zakończeniu instalacji pakietu uruchom ponownie witrynę z poziomu Akcje witryny w centrum administracyjnym.

Akcja instalacji może potrwać kilka minut. Po zakończeniu instalacji akcja zmienia się na zarządzanie.

Krok 2: Konfigurowanie dostawcy

Po zainstalowaniu pakietu można rozpocząć konfigurowanie usługi Stripe dla witryny Power Pages.

Krok 2a: Zdobądź klucze Stripe

1. W studiu projektowym wybierz Konfiguracja.

2. W sekcji Integracje wybierz Aplikacje zewnętrzne.

3. W tabeli Integracje wybierz akcję Zarządzaj dla Stripe.

4. Przejdź do Stripe Marketplace i zainstaluj aplikację Microsoft Power Pages Payments.

5. Po zainstalowaniu aplikacji należy uzyskać klucze Możliwa publikacja i Ograniczone wymagane do włączenia tej integracji. Wartości te są potrzebne w późniejszych krokach.

   Uwaga

   • W przypadku tajnego klucza zalecamy użycie ograniczonych kluczy interfejsu API dostarczanych przez usługę Stripe w celu ograniczenia dostępu i uprawnień do różnych obszarów danych Twojego konta w Stripe.
   • W wersji 9.6.3.x. dodano obsługę klawiszy trybu rzeczywistego oprócz klawiszy trybu testowego. Aby poznać różne typy kluczy, zobacz Dokumentacja Stripe dotycząca kluczy interfejsu API.

Krok 2b: Wybierz typ pamięci masowej

Do przechowywania kluczy API Stripe można użyć Dataverse (obsługuje tylko tryb testowy) lub Azure Key Vault (obsługuje zarówno tryb testowy, jak i tryb rzeczywisty).

Jeśli wybrałeś Dataverse, przejdź do kroku 2d (Dodaj klucze do konfiguracji).

Jeśli korzystasz z Azure Key Vault, dodaj klucz Stripe Restricted jako klucz tajny w magazynie kluczy i przypisz uprawnienia do swojej witryny, wykonując krok 2c (Konfiguracja Azure Key Vault (opcjonalnie)).

Krok 2c: Konfigurowanie Azure Key Vault (opcjonalnie)

Jeśli wybierzesz Azure Key Vault jako typ magazynu, wykonaj następujące kroki.

1. W Azure Portal uzyskaj nazwę swojej aplikacji w Rejestracje aplikacji, która odpowiada Twojej witrynie Power Pages.

   Nazwa aplikacji jest taka sama jak nazwa witryny z przedrostkiem „Portals-”. Jeśli nazwa witryny to „Woodgrove Bank Applications”, wówczas nazwa aplikacji w Azure Portal to „Portals-Woodgrove Bank Applications”. Zanotuj nazwę rejestracji aplikacji do wykorzystania w kolejnych krokach.

   

2. Zaloguj się do Azure portal i przejdź do magazynów kluczy.

3. Utwórz nowy skarbiec kluczy lub użyj istniejącego. Podczas tworzenia nowego magazynu kluczy należy wybrać model uprawnień. Można wybrać Kontrolę dostępu opartą na rolach Azure lub Zasady dostępu do skarbca kluczy. Aby zobaczyć odpowiednie kroki, wybierz poniższą kartę w oparciu o wybrany model uprawnień.

   Kontrola dostępu na podstawie ról na platformie Azure

   1. Przejdź do magazynu kluczy w witrynie Azure Portal.
   2. W menu wybierz pozycję Kontrola dostępu (IAM).
   3. Wybierz + Dodaj w górnej części strony, a następnie wybierz pozycję Dodaj przypisanie roli.
   4. W zakładce Role funkcji zadań wyszukaj nazwę roli Użytkownik usługi klucze tajne magazynów, zaznacz ją, a następnie wybierz Następny.
   5. Dla Przydziel dostęp do wybierz Użytkownik, grupa lub usługa główna.
   6. Wybierz + Wybierz członków i wyszukaj nazwę rejestracji aplikacji swojej witryny zgodnie z opisem na początku kroku 2c.
   7. Wybierz aplikację dla swojej witryny i wybierz Następny.
   8. Wybierz Przejrzyj + przypisz.

   Zasady dostępu usługi Key Vault

   1. W menu wybierz pozycję Zasady dostępu.
   2. W górnej części strony wybierz pozycję + Utwórz.
   3. W sekcji Uprawnienia tajne wybierz Pobierz>Następny.
   4. Wyszukaj nazwę rejestracji aplikacji swojej witryny zgodnie z opisem na początku kroku 2c.
   5. Wybierz aplikację dla witryny, a następnie wybierz Dalej.
   6. Wybierz pozycję Utwórz.

   Twoja witryna ma teraz uprawnienia do odczytu wpisów tajnych z tego magazynu kluczy.

4. Dodaj swój zastrzeżony klucz Stripe jako klucz tajny do magazynu kluczy. Aby dowiedzieć się, jak utworzyć klucz tajny w usłudze Azure Key Vault, przejdź do Ustawianie i pobieranie klucza tajnego z usługi Azure Key Vault przy użyciu Azure Portal.

Krok 2d: Dodaj klucze do konfiguracji

1. W studiu projektowym wprowadź ustawienia w panelu Włącz integrację.

   Jeśli korzystasz z opcji magazynu Dataverse, wprowadź klucze Publikowalne i tajne.

   Jeśli korzystasz z opcji magazynu kluczy, wprowadź klucz do opublikowania, nazwę Azure Key Vault i nazwę tajną.

2. Wybierz Zapisz, a następnie zamknij stronę. Jeśli napotkasz błąd podczas zapisywania, zapoznaj się z komunikatem o błędzie i rozwiąż problemy związane z konfiguracją magazynu kluczy.

3. Wybierz Synchronizuj.

Krok 3: Włączanie obsługi płatności w formularzu

Aby włączyć płatności, wykonaj następujące kroki:

1. Utwórz krok formularza wieloetapowego dla tabeli Dataverse używanej przez proces formularza wieloetapowego, w którym chcesz akceptować płatności.

2. Dodaj uprawnienia tabeli dla tabeli Dataverse używanej w procesie wieloetapowego formularza (wymagane będą co najmniej uprawnienia do Utwórz i Zapisz) i przypisanie odpowiednich ról Internet.

3. Wybierz Synchronizuj.

4. W studiu projektowania wybierz pozycję Strony i przejdź do strony internetowej, na której ma być realizowana płatność.

5. Dodaj lub edytuj formularz wieloetapowy i utwórz krok o nazwie Zapłata (lub podobnej).

6. Przejdź do Kroku ustawień.

   

   • Wybierz Integracje aplikacji.
   • Przełącz Włącz płatności cyfrowe na włączone.
   • W polu Wybierz pole kwoty wybierz pole typu waluty w tabeli używanej do pobierania kwoty, którą chcesz pobrać od użytkownika witryny.  

   Uwaga

   Konfigurację metod płatności i więcej ustawień można wykonać bezpośrednio w Stripe. Mogą one wymagać akceptacji innych warunków i konfiguracji.

Kontrola płatności jest automatycznie dodawana do kroku formularza, który pokazuje podgląd metod płatności włączonych do akceptowania płatności.

Wersja zapoznawcza i testowanie strony internetowej

Na etapie Zapłata powinna być możliwość dokonania płatności przy użyciu kart testowych dostępnych w witrynie internetowej Stripe.

Pomyślna płatność pokazuje potwierdzenie z zapłaconą kwotą i identyfikatorem transakcji zwróconym przez dostawcę usług płatniczych.

Uwaga

Wyłącz przycisk Wstecz w ustawieniach Kroku, jeśli nie chcesz, aby użytkownicy mogli przejść do poprzedniego kroku z etapu płatności.

Jeśli ten krok jest ostatnim krokiem formularza wieloetapowego, włączony jest przycisk przesyłania, który przesyła formularz i kończy proces.

Funkcja kontroli płatności w dzierżawie

Administrator może wyłączyć płatności w dzierżawie, ustawiając ustawienie poziomu dzierżawy disablePaymentIntegrationForPages za pomocą PowerShell.

Aby uruchomić polecenia cmdlet PowerShell, należy najpierw zainstalować wymagane moduły.

Wyłączanie płatności

Po zainstalowaniu modułów, uruchom poniższe polecenie w oknie PowerShell (uruchom jako administrator):

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

Administratorzy to użytkownicy posiadający jedną z następujących ról platformy Azure:

• Administrator usługi Dynamics 365
• Administrator Power Platform

Gdy funkcja płatności jest wyłączona w dzierżawie:

• Twórcy mają następujące środowisko w obszarze Aplikacje zewnętrzne.

  

• Twórcy mają następujące doświadczenie w zakładce wieloetapowej Integracje aplikacji konfiguracji formularza.

  

Każde doświadczenie zawiera następującą wiadomość:

„Ta aplikacja została wyłączona przez Twoją organizację. Skontaktuj się z administratorem, aby to włączyć”.

Uwaga

Gdy to ustawienie dzierżawy zostanie ustawione na Wszystkie, uniemożliwi to konfigurację możliwości płatności w przyszłości dla dodatkowych lokalizacji. Nie ma to wpływu na konfigurację i ustawienia płatności w formularzach, które mogły już zostać wypełnione przez twórców w ich środowiskach.

Włącz płatności

Aby włączyć funkcję płatności w dzierżawie, uruchom następujące polecenie w oknie PowerShell jako administrator:

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

Kwestie wymagające rozważenia

• Waluty i kwoty płatności. Minimalne i maksymalne wartości kwoty płatności mogą się różnić w zależności od waluty. Przejrzyj dokumentację Stripe dotyczącą obsługiwanych walut, aby upewnić się, że formularz i tabele są poprawnie skonfigurowane, aby akceptować płatności w tym zakresie.

• Zgodność ze standardem zabezpieczeń danych w branży kart płatniczych (PCI DSS). Ta funkcja korzysta z podejścia do integracji płatności, Stripe Web Elements a dane karty nie są przechowywane w Power Pages lub Dataverse. Zgodność z PCI jest wspólną odpowiedzialnością i dotyczy również biznesu. Zobacz dokumentację Stripe dotyczącą sprawdzania zgodności z PCI.

• Tabela płatności. Służy do przechowywania transakcji w rozwiązaniu zainstalowana jest nowa tabela płatności. Ta tabela jest automatycznie powiązana z tabelą wybraną podczas konfigurowania etapów formularza. Tabeli można używać do przeglądania szczegółów transakcji i ich stanu. Ta tabela to tylko wycinek dostarczonych informacji, których możesz użyć do stworzenia innych możliwości użytkownikom biznesowym w Power Apps lub Power Pages. Aby uzyskać więcej informacji i rozwiązać problemy związane z płatnościami, należy polegać na dostawcy usług płatniczych, takim jak pulpit nawigacyjny usługi Stripe.

• Element webhook. Funkcja płatności konfiguruje również element webhook w Stripe, który służy do asynchronicznego aktualizowania statusu płatności, których realizacja może zająć więcej czasu.

  Uwaga

  Gdy witryna internetowa znajduje się w trybie prywatnym, ten webhook może nie być w stanie komunikować się z Power Pages i dlatego możesz otrzymywać wiadomości e-mail od Stripe. Jest to zachowanie sporadyczne i po przełączeniu witryny w tryb publiczny webhook powinien móc pomyślnie się komunikować.