Módulo de cartão-presente
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 de presente – Este módulo pode ser usado em uma página de finalização de compra para resgatar um cartão de presente como meio de pagamento.
- Verificação de saldo cartão de presente – Este módulo pode ser usado em qualquer página para verificar o saldo em uma cartão de 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.
Propriedades do módulo
Mostrar campos adicionais– Essa propriedade define quais campos devem ser exibidos para o Cartões de presente além do número da cartão de 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 saldos em Cartões de 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:
- Dynamics 365 cartão presente – Quando essa configuração é aplicada, o módulo do cartão presente só permite o resgate de Cartões de presente 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 de presentes SVS e Givex – Quando essa configuração é aplicada, o módulo de cartão presente só permite o resgate de Cartões de presente Givex e SVS. Essa configuração tem suporte para usuários conectados e anônimos no site de comércio eletrônico.
- Dynamics 365, SVS e Cartões presente Givex – Quando essa configuração é aplicada, o módulo de cartão presente permite o resgate dos Cartões de 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 vale-presente que você deve estender antes de permitir que os vales-presentes internos sejam usados na produção:
- Número da cartão presente – As sequências numéricas são usadas para gerar números de cartão presente para Cartões internas de presente. Como as sequências numéricas podem ser facilmente previstas, você deve estender a geração de números de vale-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 para procurar saldos de cartão presentes. 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 Cartões de presentes internos não oferecem 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 vale-presente para o finalização de compra do convidado
Por padrão, os pagamentos de vale-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.
Recursos adicionais
Módulo de finalização da compra
Módulo de informações sobre retirada