Configurar integração de pagamentos

Permita que seu site do Power Pages aceite pagamentos usando o espaço de trabalho Configurar do estúdio de design. Com esta integração sem código, você pode adicionar um componente de pagamento ao seu formulário de várias etapas, permitindo que seu site seja integrado a um provedor de pagamento.

Para aceitar pagamentos em seu site do Power Pages, você deve concluir estas etapas:

Etapa 1: Instalar o pacote. Nesta etapa, o administrador do site instala o pacote consistindo de tabelas obrigatórias e outros pré-requisitos para o ambiente para habilitar a experiência de pagamentos.

Etapa 2: Configurar o provedor. Nesta etapa, o administrador do site ou criador configura chaves específicas para um provedor de pagamento.

Etapa 3: ative a experiência de pagamentos em seu formulário. Nesta etapa, o criador inclui o formulário e habilita pagamentos digitais na etapa necessária para o formulário de várias etapas.

Importante

• Este recurso só funciona com o modelo de dados avançado.
• Este recurso requer a versão de compilação do site 9.5.10.x do Power Pages para que o controle de pagamentos seja exibido no site.

Pré-requisitos

• Inscreva-se em uma conta com o Stripe como seu provedor de pagamento e obtenha o modo de teste ou as chaves dinâmicas do aplicativo de pagamentos instalado no Stripe Marketplace.
• Crie ou identifique uma tabela do Microsoft Dataverse que você deseja usar em um formulário de várias etapas. Esta tabela deve ter um campo do tipo moeda que será utilizado para cobrar o valor que você deseja cobrar do usuário do site. Para obter mais informações, consulte Como criar e modificar tabelas do Dataverse usando o espaço de trabalho Dados.
• Configurar um formulário de várias etapas usando uma tabela do Dataverse com uma etapa para permitir que os usuários paguem. Esta etapa exibe o controle de pagamentos depois de configurado em uma etapa posterior.

Etapa 1: Instalar o pacote

1. No estúdio de design, selecione Configuração.
2. Em Integrações, selecione Aplicativos externos.
3. Selecione a ação Instalar para Stripe.
4. Assim que a instalação do pacote for concluída, reinicie o site em Ações do site no centro de administração.

A ação de instalação pode levar alguns minutos. A ação é alterada para gerenciar quando a instalação é concluída.

Etapa 2: Configurar o provedor

Depois de instalar o pacote, você poderá começar a configurar o Stripe de seu site do Power Pages.

Etapa 2a: Obter as chaves do Stripe

1. No estúdio de design, escolha Configurar.

2. Em Integrações, selecione Aplicativos externos.

3. Na tabela Integrações, selecione a ação Gerenciar para o Stripe.

4. Acesse o Stripe Marketplace e instale o aplicativo Payments do Microsoft Power Pages.

5. Depois que o aplicativo for instalado, obtenha as chaves Publishable e Restricted necessárias para habilitar essa integração. Esses valores serão necessários em etapas posteriores.

   Observação

   • Para a chave secreta, recomendamos usar as chaves de API restritas que o Stripe fornece para limitar o acesso e as permissões para diferentes áreas dos dados da sua conta no Stripe.
   • A versão 9.6.3.x. adicionou suporte para teclas de modo ao vivo, além de teclas de modo de teste. Para entender os vários tipos de chaves, consulte Documentação do Stripe sobre chaves de API.

Etapa 2b: Escolher o tipo de armazenamento

Você pode usar o Dataverse (somente oferece suporte ao modo de teste) ou o Azure Key Vault (oferece suporte ao modo de teste e ao modo ao vivo) para armazenar as chaves de API do Stripe.

Se você escolher Dataverse, continue para a etapa 2d (Adicionar suas chaves à sua configuração).

Se você usar o Azure Key Vault, adicione a chave Restricted do Stripe como um segredo em um cofre de chaves e atribua permissões ao seu site seguindo a etapa 2c (Configurar Azure Key Vault (opcional)).

Etapa 2c: configurar o Azure Key Vault (opcional)

Se você escolher o Azure Key Vault como seu tipo de armazenamento, conclua as etapas a seguir.

1. Dentro do portal Azure, obtenha o nome do aplicativo em Registros de aplicativo que corresponde ao seu site do Power Pages.

   O nome do aplicativo é o mesmo do seu site com um prefixo de "Portals-". Se o nome do seu site for "Woodgrove Bank Applications", o nome do aplicativo no portal Azure será "Portals-Woodgrove Bank Applications". Observe o nome de registro deste aplicativo para uso nas etapas a seguir.

   

2. Faça login no portal do Azure e navegue até Cofres de Chaves.

3. Crie um novo cofre de chaves ou use um existente. Ao criar um novo cofre de chaves, você precisa escolher um modelo de permissão. Você pode escolher um controle de acesso baseado em função do Azure ou uma política de acesso do Key Vault. Para ver as etapas apropriadas, selecione a guia abaixo com base no modelo de permissão escolhido.

   Controle de acesso baseado em função do Azure

   1. Navegue até o cofre de chaves no portal do Azure.
   2. Selecione Controle de acesso (IAM) no menu no lado esquerdo.
   3. Selecione +Adicionar na parte superior da página e, em seguida, selecione Adicionar atribuição de função.
   4. Na guia Funções da função de trabalho, procure o nome da função Usuário dos Segredos do Key Vault, selecione-o e escolha Avançar.
   5. Para Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço.
   6. Selecione + Selecionar membros e procure o nome de registro do aplicativo do seu site, conforme descrito no início da etapa 2c.
   7. Selecione o aplicativo do site e Avançar.
   8. Selecione Revisar + atribuir.

   Políticas de acesso do cofre de chaves

   1. Selecione Políticas de acesso no menu no lado esquerdo.
   2. Selecione +Criar na parte superior da página.
   3. Em Permissões secretas, selecione Obter>Avançar.
   4. Procure o nome de registro do aplicativo do seu site, conforme descrito no início da etapa 2c.
   5. Selecione o aplicativo para o site e selecione Avançar.
   6. Selecione Criar.

   Seu site agora tem permissões para ler segredos desse cofre de chaves.

4. Adicione sua chave restrita do Stripe como um segredo ao cofre de chaves. Para saber como criar um segredo no Azure Key Vault, vá para Definir e recuperar um segredo do Azure Key Vault usando o portal do Azure.

Etapa 2d: adicionar suas chaves à sua configuração

1. No estúdio de design, insira as configurações no painel Habilitar integração.

   Se você estiver usando a opção de armazenamento do Dataverse, insira as chaves Publishable e Secret.

   Se você estiver usando a opção de armazenamento do Key Vault, insira a chave Publishable, o nome do Azure Key Vault e o nome secreto.

2. Selecione Salvar e feche o painel. Se você encontrar um erro ao salvar, consulte a mensagem de erro e resolva os problemas relacionados à configuração do cofre de chaves.

3. Selecione Sincronizar.

Etapa 3: ative a experiência de pagamentos em seu formulário

Para habilitar os pagamentos , conclua as seguintes etapas:

1. Crie uma etapa de formulário de várias etapas para a tabela do Dataverse usada em seu processo de formulário de várias etapas onde você quer aceitar os pagamentos.

2. Adicione as permissões de tabela para as tabelas do Dataverse usadas no processo do formulário de várias etapas (você precisa pelo menos das permissões Criar e Gravar) e atribua as funções da Web apropriadas.

3. Selecione Sincronizar.

4. No estúdio de design, selecione Páginas e navegue até a página da Web onde a experiência de pagamento é destinada.

5. Adicione ou edite o formulário de várias etapas e crie uma etapa chamada Pagar (ou semelhante).

6. Continue em Configurações da etapa.

   

   • Selecione Integrações de Aplicativo.
   • Ative Habilitar pagamentos digitais.
   • No campo Escolher valor, selecione o campo do tipo de moeda na tabela usada para cobrar o valor que você deseja coletar do usuário do site.  

   Observação

   A configuração dos métodos de pagamento e mais configurações podem ser feitas diretamente no Stripe. Eles podem exigir a aceitação de outros termos e configurações.

O controle de pagamento é adicionado automaticamente à etapa do formulário que mostra uma versão preliminar dos métodos de pagamento habilitados para aceitar pagamentos.

Visualize e teste sua página da Web

Na etapa Pagar, você poderá realizar um pagamento usando cartões de teste disponíveis no site do Stripe.

Um pagamento bem-sucedido mostra a confirmação com o valor pago e um ID da transação retornado pelo provedor de pagamento.

Observação

Você deve desativar o botão Voltar nas configurações da Etapa se não quiser permitir que os usuários passem para a etapa anterior da etapa de pagamento.

Se essa etapa for a última etapa do formulário de várias etapas, um botão de envio será habilitado para enviar o formulário e concluir o processo.

Controlar o recurso de pagamentos em um locatário

Um administrador pode desabilitar pagamentos em um locatário definindo a configuração de nível de locatário disablePaymentIntegrationForPages por meio do PowerShell.

Para executar cmdlets do PowerShell, você deve, primeiramente, instalar os módulos necessários.

Desabilitar pagamentos

Depois de instalar os módulos, execute o comando a seguir em uma janela do PowerShell como um administrador:

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

Administradores são os usuários que têm uma das seguintes funções do Azure:

• Administrador do Dynamics 365
• Administrador do Power Platform

Quando o recurso de pagamentos está desabilitado em um locatário:

• Os criadores têm a seguinte experiência na área Aplicativos externos.

  

• Os criadores têm a seguinte experiência na guia Integrações de aplicativo de uma configuração de formulário de várias etapas.

  

Cada experiência inclui a seguinte mensagem:

"Este aplicativo foi desabilitado pela sua organização. Entre em contato com o administrador para habilitá-lo."

Observação

Depois que essa configuração de locatário é definida como Tudo, ela impede a configuração do recurso de pagamentos no futuro para sites adicionais. Isso não afeta nenhuma definição e configuração de pagamento em formulários que possam já ter sido preenchidos pelos criadores em seus ambientes.

Habilitar pagamentos

Para habilitar o recurso de pagamentos em um locatário, execute o comando a seguir em uma janela do PowerShell:

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

Considerações

• Moedas e valores de pagamento. Os valores mínimo e máximo do valor do pagamento podem variar de acordo com as moedas. Revise a documentação do Stripe sobre moedas compatíveis para garantir que seu formulário e tabelas estejam configurados corretamente para aceitar pagamentos nessa faixa.

• Conformidade com Payment Card Industry Data Security Standard (PCI DSS) Esse recurso usa a abordagem de integração de pagamento do Stripe Web Elements, e os dados do cartão não são armazenados no Power Pages ou no Dataverse. A conformidade PCI é uma responsabilidade compartilhadas e aplica-se à empresa também. Consulte a documentação da Stripe sobre validação de conformidade com PCI.

• Tabela de pagamentos. Para armazenar transações, há uma nova tabela de pagamentos instalada com a solução. A tabela é automaticamente relacionada à tabela escolhida ao configurar as etapas do formulário. Você pode usar a tabela para visualizar os detalhes das transações e do status. Esta tabela é apenas um instantâneo das informações fornecidas que você pode usar para criar outras experiências para seus usuários empresariais no Power Apps ou no Power Pages. Para obter mais detalhes e solucionar problemas relacionados ao pagamento, você deve contar com o provedor de pagamento, como o painel do Stripe.

• Webhook. O recurso de pagamentos também configura um webhook no Stripe que é usado para atualizar de forma assíncrona o status de pagamentos que podem levar mais tempo para serem concluídos.

  Observação

  Quando um site está no modo privado, esse webhook talvez não consiga se comunicar com o Power Pages e, portanto, você pode receber emails do Stripe. Este é um comportamento intermitente e, assim que seu site for alterado para o modo público, o webhook deverá ser capaz de se comunicar com êxito.