Configurar integração de pagamentos

Permita que o seu site do Power Pages aceite pagamentos através a área de trabalho Configurar do estúdio de design. Com esta integração sem código, pode adicionar um componente de pagamento ao seu formulário com vários passos, o que permite que o seu site se integre com um fornecedor de pagamentos.

Para aceitar pagamentos no seu site do Power Pages, tem de concluir estes passos:

Passo 1: Instalar o pacote. Neste passo, o admin do site instala o pacote, composto pela tabelas obrigatórias e outros pré-requisitos para que o ambiente permita a experiência de pagamentos.

Passo 2: Configurar fornecedor. Neste passo, o admin do site ou criador configura chaves específicos para um fornecedor de pagamentos.

Passo 3: Ativar a experiência de pagamentos no seu formulário. Neste passo, o criador inclui o formulário e ativa pagamentos digitais no passo requerido para o formulário com vários passos.

Importante

• Esta caraterística só funciona com o modelo de dados avançado.
• Esta caraterística requer a versão 9.5.10.x da compilação do site do Power Pages para que o controlo de pagamentos seja apresentado no site.

Pré-requisitos

• Inscreva-se para criar uma conta com o Stripe como fornecedor de pagamento e obtenha o modo de teste ou as chaves ativas da aplicação de pagamentos instalada no Stripe Marketplace.
• Crie ou identifique uma tabela do Microsoft Dataverse que deseja usar num formulário de vários passos. Esta tabela tem de ter um campo do tipo moeda que será utilizado para cobrar o valor que pretende cobrar ao utilizador do site. Para obter mais informações, consulte Como criar e modificar tabelas do Dataverse utilizando a área de trabalho de Dados.
• Configure um formulário com vários passos que utilize uma tabela do Dataverse que com um passo para permitir que os utilizadores paguem. Este passo apresente o controle payments depois de configurado num passo posterior.

Passo 1: Instalar o pacote

1. No estúdio de design, selecione Configurar.
2. Em Integrações, selecione Aplicações externas.
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 poderá demorar alguns minutos. A ação muda para gerir assim que a instalação estiver concluída.

Passo 2: Configurar o fornecedor

Depois de instalar o pacote, pode começar a configurar o Stripe para o site do Power Pages.

Passo 2a: Obter as suas chaves Stripe

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

2. Em Integrações, selecione Aplicações externas.

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

4. Aceda ao Stripe Marketplace e instale a aplicação de Pagamentos do Microsoft Power Pages.

5. Após a instalação da aplicação, obtenha as chaves Publicáveis e Restritas necessárias para ativar esta integração. Estes valores são necessários em passos posteriores.

   Nota

   • Para a chave secreta, recomendamos a utilização das chaves de API restritas que o Stripe fornece, para limitar o acesso e as permissões a diferentes áreas dos dados da sua conta no Stripe.
   • Versão 9.6.3.x. Suporte adicionado para chaves de modo em direto, para além de chaves de modo de teste. Para compreender os vários tipos de chaves, consulte Documentação do Stripe sobre chaves de API.

Passo 2b: Escolha o seu tipo de armazenamento

Pode utilizar o Dataverse (suporta apenas o modo de teste) ou o Azure Key Vault (suporta o modo de teste e o modo em direto) para armazenar as chaves de API do Stripe.

Se optar pelo Dataverse, continue para o passo 2d (Adicionar as suas chaves à sua configuração).

Se utilizar o Azure Key Vault, adicione a chave Restrita do Stripe como um segredo num cofre de chaves e atribua permissões ao seu site seguindo o passo 2c (Configurar o Azure Key Vault (opcional)).

Passo 2c: Configurar o Azure Key Vault (opcional)

Se optar pelo Azure Key Vault como o seu tipo de armazenamento, conclua o passo seguinte.

1. No portal do Azure, obtenha o nome da sua aplicação em Registos de aplicações que corresponde ao seu site do Power Pages.

   O nome da aplicação é o mesmo que o nome do seu site com um prefixo de "Portais-". Se o nome do seu site for "Woodgrove Bank Applications", o nome da aplicação no portal do Azure será "Portais-Woodgrove Bank Applications". Anote o nome de registo da aplicação para utilização nos passos a seguir.

   

2. Inicie sessão no portal do Azure e navegue até Cofres de Chaves.

3. Crie um novo cofre de chaves ou utilize um já existente. Ao criar um novo cofre de chaves, tem de escolher um modelo de permissão. Pode escolher o controlo de acesso baseado em funções do Azure ou uma política de acesso ao Key Vault. Para ver os passos apropriados, selecione o separador abaixo com base no modelo de permissão escolhido.

   Controlo de acesso baseado em funções do Azure

   1. Navegue até ao seu cofre de chaves no portal do Azure.
   2. Selecione Controlo de acesso (IAM) no menu do lado esquerdo.
   3. Selecione + Adicionar na parte superior da página e, em seguida, selecione Adicionar atribuição de funções.
   4. No separador Funções de função do trabalho, procure o nome da função Utilizador de Segredos do Key Vault, selecione-o e, em seguida, selecione Seguinte.
   5. Para Atribuir acesso a, selecione Utilizador, grupo ou principal do serviço.
   6. Selecione + Selecionar membros e procure o nome de registo da aplicação do seu site, conforme descrito no início do passo 2c.
   7. Selecione a aplicação para o seu site e selecione Seguinte.
   8. Selecione Rever + atribuir.

   Política de acesso ao Key Vault

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

   O seu site agora tem permissões para ler segredos deste cofre de chaves.

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

Passo 2d: Adicione as suas chaves à sua configuração

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

   Se estiver a utilizar a opção de armazenamento do Dataverse, introduza as chaves Publicável e Secreta.

   Se estiver a utilizar a opção de armazenamento do Key Vault, introduza a chave Publicável, o nome do Azure Key Vault e o Nome do segredo.

2. Selecione Guardar e feche o painel. Se encontrar um erro ao guardar, consulte a mensagem de erro e resolva os problemas relacionados com a configuração do cofre de chaves.

3. Selecione Sincronizar.

Passo 3: Ative a experiência de pagamentos no seu formulário

Para ativar pagamentos, complete os seguintes passos:

1. Crie um passo de formulário com vários passos para a tabela do Dataverse utilizada no processo de formulário de vários passos onde pretende aceitar pagamento.

2. Adicione permissões de tabela para as tabelas do Dataverse utilizadas no processo de formulário com vários passos de assinatura de documentos (precisará de, pelo menos, das permissões Criar e Escrever) 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 Web onde a experiência de pagamento é pretendida.

5. Adicione ou edite o formulário com vários passos e crie um passo chamado de Pagar (ou semelhante).

6. Prossiga para Definições do passo.

   

   • Selecione Integrações de Aplicação.
   • Ligue a opção Ativar pagamentos digitais.
   • No campo Escolher valor, selecione o campo do tipo de moeda na tabela utilizado para cobrar o valor que pretende cobrar ao utilizador do site.  

   Nota

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

O controlo de pagamento é adicionado automaticamente ao passo do formulário que mostra uma pré-visualização dos métodos de pagamento com capacidade para aceitar pagamentos.

Pré-visualize e teste a sua página Web

No passo Pagar, deverá conseguir efetuar um pagamento utilizando cartões de teste disponíveis no site do Stripe.

Um pagamento bem-sucedido mostra a confirmação com o montante pago e um ID da transação obtido do fornecedor do pagamento.

Nota

Deve desativar o botão de retrocesso nas Definições do passo se não pretender permitir que os utilizadores acedam ao passo anterior do passo de pagamento.

Se este passo for o último passo do seu formulário de vários passos, será ativado um botão Submeter que submeta o formulário e conclui o processo.

Caraterística de controlo de pagamentos num inquilino

Um administrador pode desativar os pagamentos num inquilino definindo a definição de nível de inquilino disablePaymentIntegrationForPages através do PowerShell.

Para executar os cmdlets do PowerShell, tem primeiro de instalar os módulos necessários.

Desativar pagamentos

Depois de instalar os módulos, execute o seguinte comando numa janela do PowerShell como administrador:

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

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

• Administrador do Dynamics 365
• Administrador do Power Platform

Quando a caraterística de pagamentos está desativada num inquilino:

• Os criadores têm a seguinte experiência na área Aplicações externas.

  

• Os criadores têm a seguinte experiência no separador Integrações de aplicações de uma configuração do formulário de vários passos.

  

Cada experiência inclui a seguinte mensagem:

"Esta aplicação foi desativada pela sua organização. Contacte o seu administrador para ativá-la."

Nota

Assim que esta definição de inquilino estiver definida para Todos, impedirá a configuração da capacidade de pagamentos para sites adicionais. Não afeta qualquer configuração e configuração de pagamento em formulários que já possam ter sido preenchidos pelos criadores nos seus ambientes.

Ativar pagamentos

Para instalar a caraterística de pagamentos num inquilino, execute o seguinte comando numa janela do PowerShell como administrador:

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

Considerações

• Moedas e montantes de pagamento. Os montantes mínimo e máximo do valor do pagamento podem variar de acordo com as moedas. Reveja a Documentação do Stripe sobre moedas suportadas para garantir que o seu formulário e tabelas estão corretamente configurados para aceitar pagamentos nesse intervalo.

• Conformidade das Normas de Segurança de Dados do Setor de Cartões de Pagamento (PCI DSS). Esta caraterística utiliza a abordagem de integração de pagamentos dos Elementos Web do Stripe e os dados do cartão não são armazenados no Power Pages ou no Dataverse. A conformidade com PCI é uma responsabilidade partilhada e aplica-se a negócio também. Consulte a documentação do Stripe sobre a validação da sua Conformidade com o PCI.

• Tabela de pagamentos. Para armazenar transações, é instalada uma nova tabela de pagamentos com a solução. A tabela é automaticamente relacionada à tabela escolhida quando configura os passos do formulário. Pode usar a tabela para ver os detalhes de transações e o estado. Esta tabela é apenas um instantâneo das informações fornecidas, que pode usar para criar outras experiências para os seus utilizadores de empresa no Power Apps ou no Power Pages. Para obter mais detalhes e resolver problemas relacionados com o pagamento, deve contar com o fornecedor de pagamentos, como o dashboard do Stripe.

• Webhook. A caraterística de pagamentos também configura um webhook no Stripe que é usado para atualizar de forma assíncrona o estado de pagamentos que podem demorar mais tempo a concluir.

  Nota

  Quando um site está no modo privado, este webhook pode não conseguir comunicar com o Power Pages e, portanto, pode receber e-mails do Stripe. Este é um comportamento intermitente e, assim que o seu site mudar para o modo público, o webhook deve ser capaz de comunicar com sucesso.