Módulo de cartão-presente

Artigo
01/05/2024

Este artigo abrange os módulos de cartão-presente e descreve como adicioná-los a páginas de site no Microsoft Dynamics 365 Commerce.

Os módulos de cartão-presente podem ser usados em módulos de finalização de compra para aceitar cartões-presente, uma forma comum de pagamento usada para transações de comércio eletrônico. O módulo de cartão-presente oferece suporte a cartões-presente Dynamics 365, SVS e Givex. Os cartões-presente SVS e Givex são resgatados por meio do provedor de pagamentos Adyen. Para obter mais informações sobre suporte a cartões-presente externos, como SVS e Givex, consulte Suporte a cartões-presente externos.

Observação

O suporte para o resgate de vales-presentes SVS e Givex durante o fluxo de finalização de compra está disponível na versão 10.0.11 do Dynamics 365 Commerce.

Há dois módulos de cartão-presente disponíveis:

Cartão-presente - Este módulo pode ser usado em uma página de finalização de compra para resgatar um cartão-presente como meio de pagamento.
Verificação de saldo do cartão-presente - Este módulo pode ser usado em qualquer página para verificar o saldo de um cartão-presente. Este módulo está disponível nas versões 10.0.14 e posterior do Commerce.

Observação

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

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

Exemplo de um módulo de cartão-presente.

Propriedades do módulo

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

Os seguintes valores são compatíveis:
- PIN
- Data de expiração
- PIN e data de vencimento
- Nenhuma
Habilitar para usuários convidados: quando esta propriedade está habilitada, os usuários convidados podem resgatar ou consultar os saldos nos cartões-presente externos. Esta propriedade requer que o acesso anônimo (convidado) a cartões-presentes externos seja habilitado no Commerce headquarters. A configuração Habilitar para usuários convidados aplica-se somente a cartões-presentes externos. Para obter mais informações, consulte Habilitar pagamentos de cartão-presente para finalização do convidado.

Importante

A propriedade Habilitar para usuários convidados está disponível a partir da versão 10.0.21 do Commerce. Ela requer que o pacote de biblioteca do módulo da versão 9.31 do Commerce esteja instalado.

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

No construtor de sites do Commerce em Configurações de site > Extensões, há uma configuração de módulo de cartão-presente chamada Tipo de cartão-presente compatível. Esta configuração oferece suporte a três valores:

Cartão-presente do Dynamics 365 - Quando essa configuração é aplicada, o módulo do cartão-presente só permite o resgate dos cartões-presente do Dynamics 365. Essa configuração tem suporte somente para usuários conectados no site de comércio eletrônico. A funcionalidade de verificação de saldo do cartão-presente tem suporte somente para usuários conectados.
Cartões-presente SVS e Givex - Quando essa configuração é aplicada, o módulo do cartão-presente só permite o resgate dos cartões-presente Givex e SVS. Essa configuração tem suporte para usuários conectados e anônimos no site de comércio eletrônico.
Cartões-presente Dynamics 365, SVS e Givex - Quando essa configuração é aplicada, o módulo do cartão-presente só permite o resgate dos cartões-presente Dynamics 365, Givex e SVS. Essa configuração tem suporte somente para usuários conectados no site de comércio eletrônico. Devido à inclusão de cartões-presente internos, a funcionalidade de verificação de saldo do cartão-presente tem suporte somente para usuários conectados.

Importante

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

Estender cartões de presente internos para uso em lojas de comércio eletrônico

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

Número do cartão-presente - as sequências numéricas são usadas para gerar números de cartão-presente para vales-presentes internos. Como as sequências numéricas podem ser facilmente previstas, você deve estender a geração de números de cartão-presente para que sequências de caracteres de segurança aleatórias e criptografadas sejam usadas para os números de cartão de presente que são emitidos.
Getbalance – a API GetBalance é usada na pesquisa de saldos do cartão-presente. Por padrão, essa API é pública. Se um PIN não for necessário para procurar saldos do cartão-presente, há um risco que os ataques de força bruta pudessem usar a API Getbalance para tentar procurar números de cartão-presente que tenham saldos. Ao implementar os dois requisitos de PIN para vales-presentes internos e limitação de API, você pode ajudar a mitigar o risco.
PIN – por padrão, os vales-presentes internos não dão suporte a PINs. Você deve estender os vales-presentes internos para que um PIN seja necessário para pesquisar saldos. Essa funcionalidade também pode ser usada para bloquear vales-presentes após tentativas incorretas consecutivas de inserir o PIN.

Habilitar pagamentos do cartão-presente para o finalização de compra do convidado

Por padrão, os pagamentos de cartão-presente são habilitados para finalização de compra de convidado (anônimo). Para habilitá-los, siga estas etapas.

No Commerce headquarters, acesse Varejo e Comércio > Configuração de canal > Configuração do PDV > PDV > Operações de PDV.
Selecione e segure (ou clique com o botão direito do mouse) no cabeçalho da grade e, em seguida, selecione Inserir colunas.
Na caixa de diálogo Inserir colunas, marque a caixa de seleção AllowAnonymousAccess.
Selecione Atualizar.
Para operações 520 (saldo do cartão-presente) e 214, defina o valor de AllowAnonymousAccess como 1.
Selecione Salvar.
Execute o trabalho do agendador 1090 para sincronizar alterações para o banco de dados do canal.

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

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