次の方法で共有

支払い統合を設定する

  • [アーティクル]

デザイン スタジオの設定ワークスペースを使用して、Power Pages サイトで支払いを受け入れられるようにします。 このノーコードの統合により、マルチステップ フォームに支払いコンポーネントを追加して、Web サイトを支払いプロバイダーと統合できます。

Power Pages サイト内の支払い統合のスクリーンショット。

Power Pages サイトで支払いを受けるには、次の手順を完了する必要があります:

ステップ 1: パッケージをインストールする。 このステップでサイト管理者は、支払いエクスペリエンスを有効にするために、環境に必要なテーブルとその他の前提条件で構成されるパッケージをインストールします。

ステップ 2: プロバイダーを構成する。 このステップでサイト管理者または作成者は、支払いプロバイダーに固有のキーを構成します。

ステップ 3: フォームで支払いエクスペリエンスを有効にする。 このステップで作成者は、フォームを含み、マルチステップ フォームの必要なステップでデジタル決済を可能にします。

重要

前提条件

  • 支払いプロバイダーとしてStripeのアカウントにサインアップし、Stripe Marketplaceからインストールされた支払いアプリからテスト モードまたはライブ キーを取得します。
  • マルチステップ フォームで使用する Microsoft Dataverse テーブルを作成して識別します。 このテーブルには、サイト ユーザーから徴収する金額を請求するために使用される通貨フィールド タイプが必要です。 詳細については、データ ワークスペースを使用して Dataverse テーブルを作成および変更する方法を参照してください。
  • ユーザーに支払いを許可するステップを含む Dataverse テーブルを使用して、マルチステップ フォーム を構成します。 このステップでは、後のステップで構成した支払いコントロールを表示します。

手順 1 : パッケージのインストール

  1. 設計スタジオで、設定を選択します。
  2. 統合の下で、外部アプリを選択します。
  3. 選択 は、Stripeの インストール アクションを実行します。
  4. パッケージのインストールが完了したら、管理センターで サイト アクション から Web サイトを再起動します。

インストール アクションには数分かかる場合があります。 インストールが完了すると、アクションが管理に変わります。

ステップ 2: プロバイダーを構成する

パッケージをインストールしたら、Power Pages サイトの Stripe の構成を開始できます。

手順 2a: Stripe キーを取得する

  1. デザイン スタジオで 設定 を選択します。

  2. 統合の下で、外部アプリを選択します。

  3. 統合テーブルで、Stripe の 選択 アクションを選択します。

  4. Stripe Marketplace にアクセスし、 Microsoft Power Pages Paymentsアプリをインストールします。

  5. アプリをインストールしたら、この統合を有効にするために必要な 公開可能 キーと 制限付き キーを取得します。 これらの値は後の手順で必要になります。

    ヒント

    • シークレット キーについては、Stripe が提供する 制限付き API キー を使用して、Stripe でアカウント データのさまざまな領域へのアクセスとアクセス許可を制限することをお勧めします。
    • リリース9.6.3.xでは、テスト モード キーに加えてライブ モード キーのサポートが追加されました。 さまざまなタイプのキーについては、Stripe の API キーに関するドキュメント を参照してください。

手順2b: ストレージタイプを選択する

Stripe APIキーを保存するには、 Dataverse (テスト モードのみをサポート) またはAzure Key Vault (テスト モードとライブ モードの両方をサポート) を使用できます。

Power Pages デザイン スタジオのセットアップ ワークスペース内の統合の有効化パネルのスクリーンショット。

Dataverse を選択した場合は、手順 2d ( キーを構成に追加する) に進みます。

Azure Key Vault を使用する場合は、Stripe 制限キーをキーボールト内のシークレットとして追加し、手順 2c (Azure Key Vault を構成する (オプション)) に従ってサイトにアクセス許可を割り当てます。

手順2c: Azure Key Vaultを構成する (オプション)

ストレージの種類としてAzure Key Vaultを選択した場合は、次の手順を実行します。

  1. Azure ポータル内で、Power Pages Web サイトに対応する アプリの登録 のアプリの名前を取得します。

    アプリ名は、Webサイト名にプレフィックス「Portals-」が付いたものと同じです。 サイト名が 「Woodgrove Bank Applications」 の場合、Azureポータル上のアプリ名は 「Portals-Woodgrove Bank Applications」 になります。 次の手順で使用するために、このアプリ登録名をメモしておきます。

    Power Pages サイトの Azure のアプリの登録のスクリーンショット。

  2. Azure ポータルにサインインして Key Vaults に進みます。

  3. 新しいキー コンテナーを作成するか、既存のものを使用します。 新しいキーボールトを作成するときに、アクセス許可モデルを選択する必要があります。 Azureロールベースのアクセス制御 または Key Vaultアクセス ポリシーのいずれかを選択できます。 適切な手順を確認するには、選択した権限モデルに基づいて以下のタブを 選択 してください。

    1. Azure ポータルで、キー コンテナーに移動します。
    2. 左メニューで、アクセス制御 (IAM) を選択します。
    3. ページの上部の+ 追加 を選択し、ロール割り当ての追加 を選択します。
    4. 職務ロール タブで、Key Vault シークレット ユーザー ロール名を検索して選択してから次へを選択します。
    5. アクセス権の割り当て先 の場合、ユーザー、グループ、またはサービス プリンシパル を選択します。
    6. + メンバーを選択 を選択し、手順 2c の冒頭で説明したように、サイトのアプリ登録名を検索します。
    7. サイトのアプリを選択し、次へ を選択します。
    8. レビュー+ 割り当て を選択します。

    これで、サイトにこのキー コンテナーからシークレットを読み取る権限が付与されました。

  4. Stripe 制限キーをキー コンテナーのシークレットとして追加します。 Azure Key Vaultにシークレットを作成する方法については、 「Azureポータルを使用してAzure Key Vaultにシークレットを設定および取得する」を参照してください。

手順2D: 設定にキーを追加します

  1. デザイン スタジオで、統合を有効にする パネルに設定を入力します。

    Dataverse ストレージ オプションを使用している場合は、公開可能なキーと秘密キーを入力します。

    Key Vaultストレージ オプションを使用している場合は、公開可能なキー、Azure Key Vault名、およびシークレット名を入力します。

  2. 保存を選択して、パネルを閉じます。 保存中にエラーが発生した場合は、エラー メッセージを参照して、キー コンテナーのセットアップ関連の問題を解決してください。

  3. 同期 を選択します。

ステップ 3: フォームで支払いエクスペリエンスを有効にする

支払いを有効にするには、以下の手順を実行します:

  1. 支払いを受け入れるマルチステップ フォーム プロセスで使用される Dataverse テーブルのマルチステップ フォーム ステップを作成します。

  2. マルチステップ フォーム プロセスで使用される Dataverse テーブルの テーブルのアクセス許可 を追加し (少なくとも Create と Write が必要です)、適切な Web ロール を割り当てます。

  3. 同期 を選択します。

  4. デザイン スタジオで、選択 ページ に移動し、支払いエクスペリエンスを意図したWebページに移動します。

  5. マルチステップ フォーム を追加または編集し、支払い (または類似) というステップを作成します。

  6. ステップの設定 に移動します。

    Power Pages デザイン スタジオのページ ワークスペース内のステップ設定オプションのスクリーンショット。

    • アプリ統合を選択します。
    • デジタル決済を有効にする をオンに切り替えます。
    • 金額フィールドの選択 で、サイト ユーザーから徴収する金額を請求するために使用するテーブル上の通貨タイプ フィールドを選択します。  

    注意

    支払い方法の構成やその他の設定は、Stripe で直接行うことができます。 他の条件や構成への同意が必要になる場合があります。

支払いコントロールは、支払いを受け入れるために有効になっている支払方法のプレビューを表示するフォーム ステップに自動的に追加されます。

Web ページをプレビューおよびテストする

支払いステップでは、Stripe の Web サイトで入手可能なテスト カードを使用して支払いを行うことができます。

支払いが成功すると、支払金額と支払いプロバイダーから返されたトランザクション ID を含む確認が表示されます。

注意

ユーザーが支払いステップから前のステップに移動することを許可しない場合は、[ステップ設定] から [戻る] ボタンを無効にしてください。

このステップがマルチステップ フォームの最後のステップである場合、フォームを送信してプロセスを完了する送信ボタンが有効になります。

テナントの支払い機能を制御する

管理者は、PowerShell を通じて、テナント レベルの設定を disablePaymentIntegrationForPages に設定することで、テナント内の支払いを無効にすることができます。

PowerShell コマンドレットを実行するには、最初に、必須モジュールをインストールする必要があります。

支払いを無効にする

モジュールをインストールしたら、PowerShell ウィンドウで管理者として次のコマンドを実行します。

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

管理者は、次の Azure ロールのいずれかを持つユーザーです:

テナントで支払い機能が無効になっている場合:

  • 作成者は 外部アプリ 領域で次のような環境を持ちます。

    Stripe 支払い統合がブロックされている状態が表示された、統合の有効化パネルのスクリーンショット。

  • 作成者は、マルチステップ フォーム構成の アプリ統合 タブで次の環境を持っています。

    マルチステップ フォームのアプリ統合タブのスクリーンショット。

各環境には、次のメッセージが含まれます:

「このアプリケーションは組織によって無効にされています。 管理者に問い合わせてそれを有効にしてください。」

ヒント

このテナント設定を「すべて」に設定すると、今後追加のサイトで支払い機能を設定できなくなります。 これは、作成者がそれぞれの環境ですでに完了している可能性のあるフォームの構成や支払い設定には影響しません。

支払を有効化する

テナントで支払い機能を有効にするには、管理者として PowerShell ウィンドウで次のコマンドを実行します。

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

考慮事項

  • 支払い通貨と金額。 支払い額の最小値と最大値は通貨によって異なる場合があります。 サポートされている通貨に関する Stripe ドキュメント を確認して、その範囲での支払いを受け入れるようにフォームとテーブルが正しく構成されていることを確認します。

  • Payment Card Industry データ セキュリティ基準 (PCI DSS) コンプライアンス。 この機能は、Stripe Web Elements 支払い統合アプローチを使用し、カードデータは Power Pages または Dataverse に保存されません。 PCI コンプライアンスは共通の責任であり、ビジネスにも適用されます。 PCI コンプライアンスの検証 については、Stripe のドキュメントを参照してください。

  • 支払テーブル。 トランザクションを格納するために、ソリューションと共に新しい支払いテーブルがインストールされます。 テーブルは、フォーム ステップを構成するときに選択したテーブルに自動的に関連付けられます。 テーブルを使用して、トランザクションとステータスの詳細を表示できます。 このテーブルは、Power Apps または Power Pages でビジネス ユーザー向けに他のエクスペリエンスを作成するために使用できる、提供された情報のスナップショットです。 支払い関連の問題の詳細とトラブルシューティングについては、Stripe のダッシュボードなどの支払いプロバイダーに問い合わせる必要があります。

  • Webhook。 支払い機能は、完了までに余分な時間がかかる可能性がある支払いステータスを非同期に更新するために使用される Stripe 上の Webhook も構成します。

    注意

    Web サイトがプライベート モードの場合、この Webhook は Power Pages と通信できないため、Stripe からメールを受信する可能性があります。 これは断続的な動作であり、Web サイトがパブリック モードに切り替わると、Webhook は正常に通信できるようになります。