Módulo de cartão oferta

Artigo
12/11/2024

Isto artigo aborda os módulos de cartão de presente e descreve como adicioná-los às páginas do site Microsoft Dynamics 365 Commerce.

Os módulos de cartão de presente podem ser utilizados em módulos de checkout para aceitar Cartões de presente, uma forma comum de pagamento usada para transações de comércio eletrônico. O módulo de cartão presente suporta Cartões de presente Dynamics 365, SVS e Givex. Os Cartões de presente SVS e Givex são resgatados através do provedor de pagamento Adyen. Para obter mais informações sobre o suporte para Cartões de presente externos, como SVS e Givex, consulte Suporte para Cartões de presente externo.

Nota

O suporte para resgatar Cartões de presente SVS e Givex durante o Dynamics 365 Commerce fluxo de checkout está disponível na versão 10.0.11.

Existem dois módulos de cartão oferta disponíveis:

Gift cartão – Isto módulo pode ser utilizado em uma página de checkout para resgatar um cartão de presente como proposta.
Verificação de saldo de cartão de presente – Isto módulo pode ser utilizado em qualquer página para verificar o saldo de uma cartão de presente. Isto módulo está disponível na versão 10.0.14 e posterior do Commerce.

Nota

O suporte para o módulo de verificação de saldo cartão presente está disponível na Dynamics 365 Commerce versão 10.0.14.

A imagem a seguir mostra um exemplo de um módulo de cartão presente em uma página de checkout.

Exemplo de um módulo de cartão oferta.

Propriedades do properties

Mostrar campos adicionais– Esta propriedade define quais campos devem ser exibidos para Cartões de presente, além do número de cartão de presente, que é sempre exibido por padrão. Por exemplo, alguns Cartões de presente suportam a exibição de um número de identificação pessoal (PIN) e outros suportam a exibição de um PIN e data de validade. Como alternativa, essa propriedade poderia ser definida como "Nenhum", que exibiria apenas o número do cartão presente e nenhum campo adicional.

Os seguintes valores são suportados:
- PIN
- Data de validade
- PIN e data de validade
- Nenhum
Ativar para utilizadores convidados – Quando esta propriedade está ativada, os utilizadores convidados podem resgatar ou consultar saldos em Cartões de oferta externos. Esta propriedade requer que o acesso anónimo (convidado) para presente externo Cartões estar ativado em Commerce headquarters. A definição Ativar para utilizadores convidados aplica-se apenas a Cartões de oferta externos. Para obter mais informações, consulte Ativar pagamentos de cartão de presente para check-out de convidado.

Importante

A propriedade Ativar para utilizadores convidados está disponível a partir da versão 10.0.21 do Commerce. Requer que o Commerce biblioteca de módulos pacote versão 9.31 esteja instalado.

Configurações do site para módulos de cartão presente

No Commerce construtor de sites em Extensões de Configurações > do Site, há uma configuração de módulo de cartão de presente chamadaTipo de cartão de presente suportado . Esta definição suporta três valores:

Dynamics 365 cartão de presente – Quando essa configuração é aplicada, o módulo de cartão de presente só permite o resgate de Cartões de presente Dynamics 365. Esta definição só é suportada para utilizadores com sessão iniciada no site de comércio eletrónico. A funcionalidade de presente cartão saldo de verificação só é suportada para utilizadores com sessão iniciada.
Cartões de presente SVS e Givex – Quando essa configuração é aplicada, o módulo de cartão de presente só permite o resgate de Cartões de presente Givex e SVS. Esta definição é suportada para utilizadores com sessão iniciada e anónimos no site de comércio eletrónico.
Dynamics 365, SVS e Cartões de presente Givex – Quando essa configuração é aplicada, o módulo de cartão de presente permite o resgate de Cartões de presente Dynamics 365, Givex e SVS. Esta definição só é suportada para utilizadores com sessão iniciada no site de comércio eletrónico. Devido à inclusão de Cartões de presente internas, a funcionalidade de presente cartão saldo de verificação só é suportada para utilizadores com sessão iniciada.

Importante

Essas configurações estão disponíveis na Dynamics 365 Commerce versão 10.0.11 e são necessárias somente se você precisar de suporte para Cartões de presente SVS ou Givex. Se você estiver a atualizar a partir de uma versão mais antiga do Dynamics 365 Commerce, você deve atualizar manualmente o ficheiro appsettings.json. Para obter instruções sobre como atualizar o ficheiro appsettings.json, consulte SDK e atualizações biblioteca de módulos.

Estenda Cartões presentes internos para uso em vitrines de comércio eletrônico

Por padrão, os Cartões de presente internos não são otimizados para uso em vitrines de comércio eletrônico. Portanto, antes de permitir que Cartões de presente internos sejam utilizados para pagamento, você deve configurá-los com extensões que ajudem a torná-los mais seguros. Aqui estão as áreas de cartão de presentes que você deve estender antes de permitir que Cartões de presentes internos sejam utilizados na produção:

Número de cartão de presente – As sequências de números são usadas para gerar números de cartão de presente para Cartões de presente internas. Como as sequências de números podem ser facilmente previstas, você deve estender a geração de números de cartão de presente para que cadeias aleatórias e criptograficamente seguras sejam usadas para os números de cartão de presente que são emitidos.
GetBalance – A API GetBalance é usada para pesquisar saldos de cartão presentes. Por padrão, essa API é pública. Se um PIN não for necessário para procurar saldos de cartão de presentes, existe o risco de que ataques de força bruta possam usar a API GetBalance para tentar procurar números de cartão de presentes que tenham saldos. Ao implementar os requisitos de PIN para Cartões de presentes internos e a limitação de API, você pode ajudar a reduzir o risco.
PIN – Por padrão, Cartões de presente internas não suportam PINs. Você deve estender Cartões de presentes internos para que um PIN seja necessário para procurar saldos. Essa funcionalidade também pode ser usada para bloquear Cartões de presente após tentativas incorretas consecutivas de inserir o PIN.

Ativar pagamentos de cartão de presentes para check-out de hóspedes

Por predefinição, os pagamentos cartão presentes não estão ativados para check-out de hóspedes (anónimos). Para habilitá-los, siga estas etapas.

Em Commerce headquarters, vá para Configuração > de canais de retalho e comércio > Configuração de POS POS > Operações > de PDV.
Selecione e mantenha premido (ou clique com o botão direito do rato) o cabeçalho da grelha e, em seguida, selecione Inserir colunas.
Na caixa de diálogo Inserir colunas , marque a caixa de seleção AllowAnonymousAccess .
Selecione Atualizar .
Para as operações 520 (Saldo de cartão presente) e 214, defina o valor AllowAnonymousAccess como 1.
Selecione Guardar.
Execute o trabalho do agendador 1090 para sincronizar as alterações no banco de dados de canais.

Adicionar um módulo de cartão oferta a uma página

Para obter instruções sobre como adicionar um módulo de cartão presente a uma página de checkout e definir as propriedades necessárias, consulte Módulo de check-out.