Настройка интеграции с платежными системами

Включите на своем сайте Power Pages прием платежей, используя рабочую область «Настройка» студии дизайна. С помощью этой бескодовой интеграции вы можете добавить в свою многошаговую форму платежный компонент, что позволит вашему веб-сайту интегрироваться с поставщиком платежных услуг.

Для приема платежей на своем сайте Power Pages вам нужно выполнить следующие действия:

Шаг 1. Установка пакета. На этом этапе администратор сайта устанавливает пакет, состоящий из необходимых таблиц и других компонентов, для реализации в среде платежного интерфейса.

Шаг 2. Настройка поставщика. На этом этапе администратор сайта или создатель настраивает ключи, связанные с конкретным поставщиком платежных услуг.

Шаг 3. Включение платежного интерфейса в форме. На этом этапе создатель включает форму и включает цифровые платежи на необходимом шаге многошаговой формы.

Предварительные условия

• Зарегистрируйте учетную запись Stripe в качестве поставщика платежных услуг и получите тестовый режим или онлайн-ключи из платежного приложения, установленного из Stripe Marketplace.
• Создайте или определите таблицу Microsoft Dataverse, которую вы хотите использовать в многошаговой форме. В этой таблице должно быть поле типа «валюта», используемое для списания суммы, которую вы хотите получить от пользователя сайта. Дополнительные сведения см. в разделе Создание и изменение таблиц Dataverse с помощью рабочей области "Данные".
• Настройте многошаговую форму, используя таблицу Dataverse с шагом, на которым пользователи смогут производить оплату. На этом шаге отображается элемент управления оплаты, который вы настроите на более позднем этапе.

Шаг 1. Установите пакет

1. В студии дизайна выберите Настроить.
2. В разделе Интеграции выберите Внешние приложения.
3. Выберите действие Установить для Stripe.
4. По завершении установки пакета перезапустите веб-сайт из меню Действия с сайтом в центре администрирования.

Процесс установки может занять несколько минут. После завершения установки действие изменится на "Управление".

Шаг 2. Настройка поставщика

После установки пакета вы можете приступать к настройке Stripe для своего сайта Power Pages.

Шаг 2a. Получение ключей Stripe

1. В студии дизайна выберите Настроить.

2. В разделе Интеграции выберите Внешние приложения.

3. В таблице "Интеграции" выберите действие Управление для Stripe.

4. Перейдите в Stripe Marketplace и установите приложение Payment для Microsoft Power Pages.

5. После установки приложения получите Публикуемые и Ограниченные ключи, необходимые для включения этой интеграции. Эти значения понадобятся на последующих шагах.

   Заметка

   • В качестве секретного ключа рекомендуем использовать предоставляемые Stripe ключи API с ограниченным доступом, которые позволяют ограничить доступ и разрешения к различным областям данных вашей учетной записи в Stripe.
   • В версии 9.6.3.x добавлена поддержка ключей онлайн-режима в дополнение к ключам тестового режима. Для получения представления о различных типах ключей см. документацию Stripe по ключам API.

Шаг 2b. Выбор типа хранилища

Вы можете использовать Dataverse (поддерживает только тестовый режим) или Azure Key Vault (поддерживает как тестовый, так и онлайн-режимы) для хранения ключей API Stripe.

При выборе Dataverse перейдите к шагу 2d (Добавление ключей в конфигурацию).

Если вы используете Azure Key Vault, добавьте ключ с ограниченным доступом Stripe в качестве секрета в хранилище ключей и назначьте разрешения сайту, выполнив шаг 2c (Настройка Azure Key Vault (необязательно)).

Шаг 2c. Настройка Azure Key Vault (необязательно)

Если в качестве типа хранилища выбрано решение Azure Key Vault, выполните следующие действия.

1. На портале Azure получите имя вашего приложения в разделе Регистрации приложений, которое соответствует вашему веб-сайту Power Pages.

   Название приложения совпадает с названием вашего веб-сайта с префиксом "Portals-". Если ваш сайт называется "Woodgrove Bank Applications", то названием приложения на портале Azure будет "Portals-Woodgrove Bank Applications". Запишите это регистрационное имя приложения для использования на следующих шагах.

   

2. Войдите на портал Azure и перейдите в раздел Key Vaults.

3. Создайте новое хранилище ключей или используйте существующее. При создании нового хранилища ключей необходимо выбрать модель разрешений. Вы можете выбрать управление доступом на основе ролей Azure или политику доступа Key Vault. Чтобы просмотреть соответствующие действия, перейдите на вкладку ниже в зависимости от выбранной модели разрешений.

   • Управление доступом на основе ролей Azure
   • Политики доступа Key Vault

   1. Перейдите к хранилищу ключей на портале Azure.
   2. Выберите Управление доступом (IAM) в меню слева.
   3. Выберите + Добавить в верхней части страницы, а затем выберите Добавить назначение ролей.
   4. На вкладке Роли функциональных обязанностей найдите имя роли пользователя секрета Key Vault, выберите его и нажмите Далее.
   5. Для пункта Назначить доступ выберите Пользователь, группа или субъект-служба.
   6. Выберите + Выбрать участников и выполните поиск регистрационного имени приложения вашего сайта, как описано в начале шага 2c.
   7. Выберите приложение для своего сайта и нажмите Далее.
   8. Выберите Проверить + назначить.

   Теперь у вашего сайта есть разрешения на чтение секретов из этого хранилища ключей.

4. Добавьте свой ключ с ограниченным доступом Stripe в качестве секрета в хранилище ключей. Чтобы узнать, как создать секрет в Azure Key Vault, перейдите в раздел Настройка и получение секрета в Azure Key Vault с помощью портала Azure.

Шаг 2d. Добавление ключей в конфигурацию

1. В студии дизайна введите настройки на панели Включить интеграцию.

   Если вы используете хранилище Dataverse, введите "Публикуемые" и "Секретные" ключи.

   Если вы используете хранилище Key Vault, введите "Публикуемый" ключ, имя Azure Key Vault и имя "Секрета".

2. Выберите Сохранить и закройте панель. Если вы столкнулись с ошибкой во время сохранения, обратитесь к сообщению об ошибке и устраните проблемы, связанные с настройкой хранилища ключей.

3. Выберите Синхронизировать.

Шаг 3. Включение платежного интерфейса в форме

Чтобы включить платежи, выполните следующие действия:

1. Создайте шаг многошаговой формы для таблицы Dataverse, используемой в процессе многошаговой формы, на котором вы хотите принимать платежи.

2. Добавьте разрешения в отношении таблиц Dataverse, используемых в процессе многошаговой формы (вам нужны как минимум разрешения Создание и Запись) и назначьте соответствующие веб-роли.

3. Выберите Синхронизировать.

4. В студии дизайна выберите Страницы и перейдите на веб-страницу, на которой предполагается произвести оплату.

5. Добавьте или отредактируйте многошаговую форму и создайте шаг с названием Оплата (или аналогичным).

6. Переходите к разделу Параметры этапа.

   

   • Выберите Интеграции приложений.
   • Включите параметр Включить цифровые платежи.
   • В поле Выберите сумму выберите поле типа валюты в таблице, используемой для списания суммы, которую вы хотите получить от пользователя сайта.  

   Заметка

   Настройку способов оплаты и других параметров можно осуществить непосредственно в Stripe. Это может потребовать принятия других условий и конфигурации.

Элемент управления «оплата» автоматически добавляется на шаг формы, на котором отображается предварительных просмотр способов оплаты, включенных для приема платежей.

Предварительный просмотр и тестирование веб-страницы

На шаге «Оплата» вы можете совершить оплату с использованием тестовых карт, доступных на веб-сайте Stripe.

В случае успешного платежа отображается подтверждение с уплаченной суммой и идентификатором транзакции, возвращенным поставщиком платежных услуг.

Если этот шаг является последним шагом многошаговой формы, активируется кнопка отправки, которая отправляет форму и завершает процесс.

Функция управления платежами в клиенте

Администратор может отключить платежи в клиенте, задав параметр disablePaymentIntegrationForPages на уровне клиента с помощью PowerShell.

Для выполнения командлетов PowerShell следует сначала установить необходимые модули.

Отключение платежей

После установки модулей выполните следующую команду в окне PowerShell от имени администратора:

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

Администраторами являются пользователи с одной из следующих ролей Azure:

• Администратор Dynamics 365
• Администратор Power Platform

Если функция платежей отключена в клиенте:

• У создателей есть следующий интерфейс в области Внешние приложения.

  

• У создателей есть следующий интерфейс на вкладке Интеграции приложений конфигурации многошаговой формы.

  

Каждый интерфейс содержит следующее сообщение:

"Это приложение отключено вашей организацией. Обратитесь к администратору, чтобы включить его".

Включить платежи

Чтобы включить функцию платежей в клиенте, выполните следующую команду в окне PowerShell от имени администратора:

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

Рекомендации

• Валюты и суммы платежей. Значения минимальной и максимальной суммы платежа могут различаться в зависимости от валюты. Ознакомьтесь с документацией Stripe по поддерживаемым валютам, чтобы убедиться, что ваша форма и таблицы правильно настроены для приема платежей в этом диапазоне.

• Соответствие стандарту безопасности данных (PCI DSS) в сфере платежных карт. Эта функция использует подход интеграции платежей Веб-элементы Stripe, и данные карты не сохраняются в Power Pages или Dataverse. Ответственность за обеспечение соответствия PCI является общей, и распространяется в том числе на бизнес. См. документацию Stripe по проверке соответствия PCI.

• Таблица платежей. Для хранения транзакций вместе с решением устанавливается новая таблица платежей. Таблица автоматически связывается с таблицей, которую вы выбираете при настройке шагов формы. Вы можете использовать эту таблицу для просмотра сведений о транзакциях и их статуса. Эта таблица представляет собой не более чем моментальный снимок предоставленной информации, которую вы можете использовать для создания других возможностей для своих бизнес-пользователей в Power Apps или Power Pages. Для получения более подробной информации и устранения проблем, связанных с платежами, обратитесь к поставщику платежных услуг, например на панель управления Stripe.

• Веб-перехватчик. Функция платежей также настраивает в Stripe веб-перехватчик, используемый для асинхронного обновления статуса платежей, для совершения которых может потребоваться дополнительное время.

  Заметка

  Когда веб-сайт находится в приватном режиме, у этого веб-перехватчика может не быть возможности взаимодействовать с Power Pages, в результате чего вы можете получать сообщения электронной почты от Stripe. Такое поведение является временным; как только веб-сайт будет переведен с общедоступный режим, веб-перехватчик, скорее всего, сможет успешно обмениваться с ним данными.