Módulo de pagamento

Artigo
03/12/2024

Este artigo aborda o módulo de pagamento e explica como configurá-lo no Microsoft Dynamics 365 Commerce.

Aviso

O padrão do Dynamics 365 Commerce para o comportamento de pagamento do PayPal e do Google Pay Express não é atualmente recomendado para regiões que aplicam os requisitos da PSD2 (Diretiva de Serviços de Pagamento Revista). Os padrões de pagamento expresso do módulo de pagamento do Commerce calculam o preço final da encomenda na página Finalização da compra do Commerce quando obtém o endereço de entrega da encomenda de um utilizador. A PSD2 recomenda que os utilizadores vejam o preço total completo da encomenda dentro da janela de autenticação da carteira digital. O Commerce monitorizará o trabalho futuro para atualizar o comportamento dos módulos do PayPal e do Google Pay para suportar fluxos expressos, atualizando os detalhes da encomenda na janela de pagamento da carteira quando um endereço de entrega for selecionado.

O módulo de pagamento permite que os clientes paguem encomendas utilizando cartões de crédito ou de débito. A integração de pagamentos deste módulo é fornecida pelo Dynamics 365 Payment Connector para Adyen. Para mais informações sobre como preparar e configurar o conector de pagamento, consulte Dynamics 365 Payment Connector para Adyen.

A partir da versão 10.0.14 do Commerce, o módulo de pagamento foi integrado com o Dynamics 365 Payment Connector para PayPal para permitir que os clientes paguem encomendas utilizando o PayPal. Para mais informações sobre como preparar e configurar o Dynamics 365 Payment Connector para PayPal, consulte Dynamics 365 Payment Connector para PayPal.

Dynamics 365 Payment Connector para Adyen

O módulo de pagamento hospeda as informações de pagamento que são servidas via Adyen num elemento de frame inline (iframe) HTML. O módulo de pagamento interage com a Commerce Scale Unit para obter as informações de pagamento da Adyen. Como parte da interação da Commerce Scale Unit, o módulo de pagamento pode permitir que as informações do endereço para faturação sejam servidas no elemento iframe via Adyen ou como um módulo separado. No tema Fabrikam, o endereço para faturação é ativado como um módulo separado. Esta abordagem permite uma maior flexibilidade de formatação, porque as linhas de endereço podem ser compostas de modo a que se pareçam com as linhas do endereço para envio.

O módulo de pagamento também permite que os clientes com sessão iniciada guardem as respetivas informações de pagamento. As informações de pagamento e o endereço para faturação são guardados e geridos via o conector de pagamento da Adyen.

O módulo de pagamento cobre quaisquer custos de encomenda que ainda não estejam cobertos por pontos de fidelização ou um cartão presente. Se o total de uma encomenda for totalmente coberto por pontos de fidelização ou créditos de cartão presente, o módulo de pagamento será oculto e o cliente poderá fazer o pedido sem ele.

O conector de pagamento da Adyen também suporta a autenticação segura de clientes (SCA). Parte da PSD2 (Diretiva de Serviços de Pagamento Revista) da União Europeia (EU) requer que os compradores online sejam autenticados fora da sua experiência de compra online quando utilizam um método de pagamento eletrónico. Durante o fluxo de finalização de pagamento, os clientes são redirecionados para o site do banco e, após a autenticação, são redirecionados de volta para o fluxo de finalização da compra do Commerce. Durante este redirecionamento, as informações que um cliente introduziu durante o fluxo de finalização da compra (por exemplo, endereço de entrega, opções de entrega, informações de cartão presente e informações de fidelização) persistem. Antes de poder ativar a caraterística do conector de pagamento da Adyen, o conector de pagamento tem de ser configurado para SCA no Commerce headquarters. Para mais informações, consulte Autenticação Segura de Clientes com a Adyen. Esta caraterística foi ativada na versão 10.0.12 do Commerce.

Nota

Para o conector de pagamento da Adyen, o elemento iframe no módulo de pagamento pode ser composto apenas se adicionar o URL da Adyen à lista de permissões do seu site. Para concluir este passo, adicione *.adyen.com às diretivas child-src, connect-src, img-src, script-src e style-src da política de segurança de conteúdo do seu site. Para mais informações, consulte Gerir a Política de Segurança de Conteúdo.

A ilustração a seguir mostra um exemplo de cartão presente, de fidelização e módulos de pagamento da Adyen numa página de finalização da compra.

Exemplo de cartão presente, de fidelização e módulos de pagamento da Adyen numa página de finalização da compra.

Dynamics 365 Payment Connector para PayPal

A partir da versão 10.0.14 do Commerce, o módulo de pagamento também está integrado com o Dynamics 365 Payment Connector para PayPal. Para mais informações sobre como preparar e configurar este conector de pagamento, consulte Dynamics 365 Payment Connector para PayPal.

Na página de finalização da compra, pode ter ambos os conectores Adyen e PayPal configurados. O módulo de pagamento tem propriedades para ajudar a identificar com que conector deve trabalhar. Para mais detalhes, consulte as propriedades do módulo Tipos de procedimentos suportados e É o pagamento principal na tabela que se segue.

Quando o módulo de pagamento está configurado para utilizar o conector de pagamento do PayPal, aparece um botão PayPal na página de finalização da compra. Quando invocado pelo cliente, o módulo de pagamento compõe um elemento iframe que contém informações do PayPal. O cliente pode iniciar sessão e fornecer as suas informações do PayPal dentro deste elemento iframe para concluir a transação. Quando um cliente opta por pagar com PayPal, o saldo restante na encomenda é cobrado via PayPal.

O conector de pagamento do PayPal não requer um módulo de endereço para faturação porque o PayPal trata de todas as informações relacionadas com faturação no respetivo elemento iframe. No entanto, os módulos de endereço para envio e opções de entrega são obrigatórios.

A ilustração que se segue mostra um exemplo de dois módulos de pagamento numa página de finalização da compra, um configurado com o conector de pagamento da Adyen e o outro com o conector de pagamento do PayPal. Exemplo de módulos de pagamento da Adyen e do PayPal numa página de finalização da compra.

A ilustração seguinte mostra um exemplo do elemento iframe do PayPal invocado através do botão PayPal.

Propriedades do módulo de pagamento

Nome da propriedade	Valores	Descrição
Título	Texto de cabeçalho	Um título opcional para o módulo de pagamento.
Altura do elemento iframe	Píxeis	A altura do elemento iframe, em pixels. A altura pode ser ajustada conforme necessário.
Mostrar endereço para faturação	True ou False	Se esta propriedade estiver definida como True, o endereço para faturação será servido pela Adyen dentro do elemento iframe do módulo de pagamento. Se definido como False, o endereço para faturação não é fornecido pela Adyen e tem de configurar um módulo para mostrar o endereço para faturação na página de finalização da compra. Este campo não afeta o conector de pagamento do PayPal porque o endereço para faturação é processado pelo PayPal.
Substituição do estilo de pagamento	Código CSS (Cascading Style Sheets)	Como o módulo de pagamento está alojado num elemento iframe, as capacidades de personalização são limitadas. Pode conseguir alguma personalização através desta propriedade. Para substituir estilos de site, tem de colar o código CSS como o valor desta propriedade. As substituições e personalizações do CSS do construtor de sites não se aplicam a este módulo.
Tipos de pagamento suportados	Cadeia	Se estiverem configurados vários conectores de pagamento, deve fornecer a cadeia de carateres do tipo de procedimento suportada, conforme definido na configuração do conector de pagamento do Commerce headquarters (veja a imagem que se segue). Se estiver em branco, a predefinição será o conector de pagamento da Adyen. Adicionado na versão 10.0.14 do Commerce.
É o pagamento principal	True ou False	Se True, qualquer mensagem de erro é gerada a partir do conector de pagamento principal na página de finalização da compra. Se os conectores de pagamento da Adyen e do PayPal estiverem configurados, defina Adyen como True.
Utilizar ID do conector	True ou False	Utilize esta propriedade se estiverem configurados vários conectores de pagamento para o site. Se True, os conectores têm de usar o ID do conector para correlação de pagamento.
Utilizar o código de idioma definido do browser para o elemento iframe	True ou False	(Só Adyen) Se True, o elemento iframe da Adyen compõe o idioma com base no contexto do browser do utilizador do site, em vez de usar o código de idioma do canal do Commerce configurado para o site.

A ilustração que se segue mostra um exemplo do valor dos Tipos de Procedimento Suportados definido como "PayPal" na configuração do conector de pagamento no Commerce headquarters. Exemplo de tipos de procedimentos suportados no Commerce headquarters.

Endereço para faturação

Um módulo de endereço para faturação pode ser utilizado na página de finalização da compra se as linhas de endereço para faturação do conector de pagamento da Adyen não corresponderem suficientemente à aparência do resto do site.

Para usar um módulo de endereço para faturação na página de finalização da compra quando o módulo de pagamento está integrado com o conector de pagamento da Adyen, defina a propriedade Mostrar endereço para faturação como False para que um módulo de endereço para faturação dedicado possa ser utilizado em vez do endereço para faturação predefinido da Adyen. Neste caso, o autor do site deve incluir um módulo de endereço para faturação na página de finalização da compra. O conector de pagamento da Adyen também permite a capacidade de usar o endereço para envio como o endereço para faturação, para minimizar o número de passos para o utilizador do site.

A propriedade Tipos de procedimentos suportados está presente no módulo de endereço para faturação. O valor desta propriedade deve ser idêntico ao valor fornecido no módulo de pagamento para garantir que trabalham em conjunto. Para o conector de pagamento da Adyen, tanto o módulo de pagamento quanto o módulo de endereço para faturação devem deixar esse valor em branco (o estado predefinido). Para o conector da PayPal, não é necessário um módulo de endereço para faturação dedicado. Para outros tipos de conetores de pagamento, a cadeia deve ser fornecida conforme configurado no Commerce headquarters.

Adicionar um módulo de pagamento a uma página de finalização da compra e definir as propriedades necessárias

Um módulo de pagamento só pode ser adicionado a um módulo de finalização da compra. Para mais informações sobre como configurar um módulo de pagamento para uma página de finalização da compra, consulte Módulo de finalização da compra.

Configurar os conectores de pagamento da Adyen e do PayPal quando forem ambos utilizados

Se os conectores de pagamento da Adyen e do PayPal forem utilizados no seu site, siga estes passos no construtor de sites do Commerce para adicionar módulos de pagamento para cada conector ao módulo de finalização da compra e, em seguida, configure as propriedades de cada módulo.

No painel de propriedades do módulo de pagamento do PayPal, siga estes passos:
1. No campo para a propriedade Tipos de procedimentos suportados, introduza PayPal.
2. Desmarque a caixa de verificação da propriedade É o pagamento principal.
3. Marque a caixa de verificação da propriedade Utilizar ID do conector.
No painel de propriedades do módulo de pagamento da Adyen, siga estes passos:
1. Deixe o campo para a propriedade Tipos de procedimentos suportados em branco.
2. Selecione a caixa de verificação da propriedade É o pagamento principal.
3. Marque a caixa de verificação da propriedade Utilizar ID do conector.

Nota

Quando configurar os conectores da Adyen e do PayPal para serem utilizados em conjunto, a configuração do Dynamics 365 Payment Connector para Adyen tem de estar na primeira posição na configuração do conector de Contas de pagamento do canal online no Commerce headquarters. Para confirmar ou alterar a ordem dos conectores, aceda a Lojas Online e selecione o canal do seu site. Em seguida, no separador Configuração, no Separador Rápido Contas de pagamento, em Conector, certifique-se de que a configuração do Dynamics 365 Payment Connector para Adyen está na primeira posição (ou seja, na linha superior) e de que a configuração do Dynamics 365 Payment Connector para PayPal está na segunda linha. Adicione ou remova conectores conforme necessário para reordená-los.