Nastavení integrace plateb

Povolte svému webu Power Pages přijímat platby pomocí pracovního prostoru Nastavení designového studia. Díky této integraci bez kódu můžete do vícekrokového formuláře přidat platební komponentu, která umožní integraci vašeho webu s poskytovatelem plateb.

Chcete-li přijímat platby na svém webu Power Pages, musíte provést tyto kroky:

Krok 1: Nainstalujte balíček. V tomto kroku správce webu nainstaluje balíček skládající se z požadovaných tabulek a dalších předpokladů pro prostředí, aby bylo možné povolit prostředí plateb.

Krok 2: Nakonfigurujte poskytovatele. V tomto kroku správce webu nebo tvůrce konfiguruje konkrétní klíče pro poskytovatele plateb.

Krok 3: Povolte ve formuláři platební prostředí. V tomto kroku tvůrce zahrne formulář a zapne digitální platby v požadovaném kroku vícekrokového formuláře.

Důležité

• Tato funkce funguje pouze s rozšířeným datovým modelem.
• Tato funkce vyžaduje sestavení webu verze Power Pages 9.5.10.x, aby se na webu zobrazoval ovládací prvek plateb.

Předpoklady

• Zaregistrujte si účet u Stripe jako poskytovatele plateb a získejte testovací režim nebo živé klíče z platební aplikace nainstalované ze Stripe Marketplace.
• Vytvořte nebo identifikujte tabulku Microsoft Dataverse, kterou chcete použít ve vícekrokovém formuláři. Tato tabulka musí mít typ pole měny, který se používá k účtování částky, kterou chcete vybrat od uživatele webu. Další informace najdete v tématu Vytvoření a úprava tabulek Dataverse pomocí pracovního prostoru Data.
• Nakonfigurujte formulář s více kroky pomocí tabulky Dataverse, který má krok umožňující uživatelům provádět platby. Tento krok zobrazí ovládací prvek plateb po konfiguraci v pozdějším kroku.

Krok 1: Nainstalujte balíček

1. V návrhovém studiu vyberte Nastavení.
2. V části Integrace vyberte Externí aplikace.
3. Vyberte akci Instalovat pro Stripe.
4. Po dokončení instalace balíčku restartujte web z Akcí webu v centru pro správu.

Instalační akce může trvat několik minut. Po dokončení instalace se akce změní na správu.

Krok 2: Konfigurace poskytovatele

Jakmile nainstalujete balíček , můžete začít konfigurovat Stripe pro svůj web Power Pages.

Krok 2a: Získání klíčů Stripe

1. V designovém studiu si vyberte Nastavit.

2. V části Integrace vyberte Externí aplikace.

3. V tabulce Integrace vyberte akci Spravovat pro Stripe.

4. Přejděte na Stripe Marketplace a nainstalujte Microsoft Power Pages aplikaci Platby.

5. Po instalaci aplikace získejte publikovatelné a omezené klíče potřebné k povolení této integrace. Tyto hodnoty jsou potřeba v pozdějších krocích.

   Poznámka:

   • Pro tajný klíč doporučujeme použít omezené klíče rozhraní API, které Stripe poskytuje k omezení přístupu a oprávnění pro různé oblasti dat vašeho účtu ve Stripe.
   • Verze 9.6.3.x. přidala kromě kláves testovacího režimu také podporu kláves živého režimu. Chcete-li porozumět různým typům klíčů, viz Dokumentace Stripe týkající se klíčů rozhraní API.

Krok 2b: Vyberte typ úložiště

K uložení klíčů rozhraní API Stripe můžete použít Dataverse (podporuje pouze testovací režim) nebo Azure Key Vault (podporuje testovací režim i živý režim).

Pokud vyberete Dataverse, pokračujte krokem 2d (Přidání klíčů do konfigurace).

Pokud používáte Azure Key Vault, přidejte klíč s omezeným proužkem jako tajný kód do trezoru klíčů a přiřaďte oprávnění k webu podle kroku 2c (Konfigurace Azure Key Vault (volitelné)).

Krok 2c: Konfigurace Azure Key Vault (volitelné)

Pokud jako typ úložiště zvolíte Azure Key Vault, proveďte následující kroky.

1. Na portálu Azure získejte v části Registrace aplikací název aplikace, který odpovídá vašemu webu Power Pages.

   Název aplikace je stejný jako název vašeho webu s předponou "Portals-". Pokud je název vašeho webu "Woodgrove Bank Applications", pak název aplikace na portálu Azure je "Portals-Woodgrove Bank Applications". Poznamenejte si tento název registrace aplikace pro použití v následujících krocích.

   

2. Přihlaste se na web Azure Portal a přejděte na Key Vaults.

3. Vytvořte nový trezor klíčů nebo použijte již existující. Při vytváření nového trezoru klíčů musíte zvolit model oprávnění. Můžete zvolit buď Řízení přístupu Azure na základě rolí nebo Zásady přístupu Key Vault. Pokud chcete zobrazit příslušné kroky, vyberte níže uvedenou kartu na základě vašeho výběru modelu oprávnění.

   Řízení přístupu na základě rolí Azure

   1. Přejděte na svůj trezor klíčů na webu Azure portal.
   2. V nabídce vlevo vyberte příkaz Řízení přístupu (IAM).
   3. V horní části stránky vyberte + Přidat a pak vyberte Přidat přiřazení role.
   4. Na kartě Role funkcí úloh vyhledejte Uživatel tajných kódů trezoru klíčů, vyberte ho a pak vyberte Další.
   5. Pro Přiřadit přístup k vyberte Uživatel, skupina nebo instanční objekt.
   6. Vyberte + Vybrat členy a vyhledejte název registrace aplikace vašeho webu, jak je popsáno na začátku kroku 2c.
   7. Vyberte aplikaci pro svůj web a vyberte Další.
   8. Vyberte Zkontrolovat + přiřadit.

   Zásady přístupu Key Vault

   1. V nabídce vlevo vyberte příkaz Zásady přístupu.
   2. V horní části stránky vyberte + Vytvořit.
   3. V části Oprávnění k tajným kódům vyberte Získat>další.
   4. Vyhledejte název registrace aplikace vašeho webu, jak je popsáno na začátku kroku 2c.
   5. Vyberte aplikaci pro web a pak vyberte Další.
   6. Vyberte Vytvořit.

   Váš web teď má oprávnění ke čtení tajných kódů z tohoto trezoru klíčů.

4. Přidejte svůj omezený kód Stripe jako tajný kód do trezoru klíčů. Pokud se chcete dozvědět, jak vytvořit tajný kód v Azure Key Vault, přejděte na Nastavení a načtení tajného kódu z Azure Key Vault pomocí webu Azure Portal.

Krok 2d: Přidání klíčů do konfigurace

1. V návrhovém studiu zadejte nastavení na panelu Povolit integraci.

   Pokud používáte možnost úložiště Dataverse, zadejte publikovatelné a tajné klíče.

   Pokud používáte možnost úložiště Key Vault, zadejte publikovatelný klíč, Azure název trezoru klíčů a název tajného klíče.

2. Vyberte Uložit a potom zavřete panel. Pokud při ukládání narazíte na chybu, přečtěte si chybovou zprávu a vyřešte problémy související s nastavením trezoru klíčů.

3. Vyberte Synchronizovat.

Krok 3: Povolte ve formuláři platební prostředí.

Chcete-li povolit platby, proveďte následující kroky:

1. Vytvořte krok vícekrokového formuláře pro tabulku Dataverse použitou v procesu vícekrokového formuláře, kde chcete přijímat platby.

2. Přidejte oprávnění k tabulce pro tabulku Dataverse používanou v procesu vícekrokového formuláře podpisu dokumentu (budete potřebovat alespoň oprávnění Vytvořit a Zapisovat) a přiřaďte příslušné webové role.

3. Vyberte Synchronizovat.

4. V návrhovém studiu vyberte Stránky a přejděte na webovou stránku, na které je zamýšleno prostředí pro platby.

5. Přidejte nebo upravte vícekrokový formulář a vytvořte krok nazvaný Zaplatit (nebo podobný).

6. Pokračujte do Nastavení kroků.

   

   • Vyberte Integrace aplikací.
   • Přepněte možnost Povolit digitální platby na zapnuto.
   • V poli Vybrat částku vyberte pole typu měny v tabulce, která slouží k naúčtování částky, kterou chcete vybrat od uživatele webu.  

   Poznámka:

   Konfigurace platebních metod a další nastavení lze provést přímo ve Stripe. Mohou vyžadovat přijetí jiných podmínek a konfigurace.

Ovládací prvek plateb je automaticky přidán do kroku formuláře, který zobrazuje náhled platebních metod povolených pro přijímání plateb.

Prohlédněte si a otestujte svůj web

V kroku Zaplatit byste měli být schopni provést platbu pomocí testovacích karet dostupných na webu Stripe.

Úspěšná platba zobrazuje potvrzení se zaplacenou částkou a ID transakce vrácené od poskytovatele platby.

Poznámka:

Pokud nechcete, aby uživatelé přešli na předchozí krok z kroku platby, měli byste vypnout tlačítko Zpět v nastaveních kroku.

Pokud je tento krok posledním krokem vícekrokového formuláře, je povoleno tlačítko Odeslat, které formulář odešle a dokončí proces.

Funkce řízení plateb v klientovi

Správce může zakázat platby v klientovi nastavením disablePaymentIntegrationForPages na úrovni klienta prostřednictvím PowerShell.

Chcete-li spustit rutiny PowerShell, musíte nejprve nainstalovat požadované moduly.

Zakázání plateb

Po instalaci modulů spusťte následující příkaz v okně PowerShell jako správce:

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

Správci jsou uživatelé, kteří mají jednu z následujících rolí Azure:

• Správce Dynamics 365
• Správce Power Platform

Když je funkce plateb v klientovi zakázána:

• Tvůrci mají v oblasti Externí aplikace následující možnosti.

  

• Tvůrci mají následující zkušenosti s kartou Integrace aplikací konfigurace formuláře s více kroky.

  

Každá zkušenost obsahuje následující zprávu:

"Tato aplikace byla zakázána vaší organizací. Požádejte správce o její povolení."

Poznámka:

Jakmile je toto nastavení klienta nastaveno na Vše, zabrání nastavení možnosti plateb pro další weby. Nemá vliv na konfiguraci a nastavení plateb na formulářích, které již tvůrci vyplnili ve svém prostředí.

Povolit platby

Pokud chcete povolit funkci plateb v klientovi, spusťte následující příkaz v okně PowerShell jako správce:

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

Důležité informace

• Platební měny a částky. Hodnoty minimální a maximální částky platby se mohou lišit podle měn. Prostudujte si dokumentaci Stripe pro podporované měny a ujistěte se, že váš formulář a tabulky jsou správně nakonfigurovány pro přijímání plateb v tomto rozsahu.

• Standard zabezpečení dat (DSS) odvětví platebních karet (PCI) Tato funkce využívá přístup integrace plateb Stripe Web Elements a data karty se neukládají do Power Pages nebo Dataverse. Dodržování předpisů PCI je sdílenou odpovědností a používá se také na podniky. Viz dokumentace Stripe k ověření vašeho dodržování předpisů PCI.

• Tabulka plateb. Pro uchovávání transakcí je spolu s řešením nainstalována nová tabulka plateb. Tabulka se automaticky vztahuje k tabulce, kterou vyberete při konfiguraci kroků formuláře. Tabulku můžete použít k zobrazení podrobností o transakcích a stavu. Tato tabulka je pouhým přehledem poskytnutých informací, které můžete použít k vytvoření dalších prostředí pro vaše firemní uživatele v Power Apps nebo Power Pages. Pro více podrobností a řešení problémů souvisejících s platbami byste se měli spolehnout na poskytovatele plateb, jako je například řídicí panel Stripe.

• Webhook. Funkce plateb také konfiguruje webhook na Stripe, který se používá k asynchronní aktualizaci stavu plateb, jejichž dokončení může trvat déle.

  Poznámka:

  Když je web v soukromém režimu, tento webhook nemusí být schopen komunikovat s Power Pages, a proto můžete dostávat e-maily od Stripe. Jedná se o přerušované chování a jakmile se váš web přepne do veřejného režimu, webhook by měl být schopen úspěšně komunikovat.