Configurações gerais do widget

As configurações a seguir permitem que você personalize o comportamento e a aparência do checkout para atender às necessidades específicas de cada comerciante.

Idioma#

O idioma da interface de checkout é configurado automaticamente com base no país em que sua empresa opera.

Essa configuração visa garantir uma experiência localizada aos compradores, reduzindo atritos e melhorando as taxas de conversão.

• A linguagem é definida através da tokenização de pedidos.
• O idioma pode ser especificado dinamicamente para cada pedido.

URL base#

Se desejar personalizar um URL base específico para seus links de pagamento, você pode solicitá-lo à nossa equipe de suporte. Essa personalização permite adaptar a experiência à identidade da sua marca.

Exemplo: https://payhere.yourbrand.deuna.com

Habilitar autenticação de usuário#

DEUNA permite configurar se seus clientes finalizam a compra como convidados ou como usuários autenticados, com acesso aos cartões salvos e aos dados de compras anteriores. Esse comportamento é controlado por duas variáveis:

Ambas as variáveis são configuradas dentro widgets_general_config.user_experience ao criar ou atualizar sua configuração de comerciante:

{
  "widgets_general_config": {
    "user_experience": {
      "user_authentication_flow": true,
      "init_with_guest_user": false
    }
  }
}

Como é decidido se um usuário vê o fluxo autenticado?

Se você definir user_authentication_flow: true, a DEUNA determina qual usuário mostrar (e, portanto, quais cartões salvos) seguindo uma ordem de prioridade. Um valor definido em um nível superior sempre substitui os níveis abaixo dele:

Exemplo — inicializando com um explícitouserToken:

deunaSDK.initElements({
  orderToken: "YOUR_ORDER_TOKEN",
  userToken: "YOUR_USER_TOKEN", // overrides merchant config and order email
  // ...other initialization parameters
});

Substituindo na inicialização: onlyCardEnrollment

Parâmetros enviados para dentro behavior ao inicializar o WebSDK permitem que você substitua determinados fluxos definidos na configuração do seu comerciante, sem alterar a configuração em si.

onlyCardEnrollment oculta os cartões salvos de um usuário autenticado, permitindo apenas o cadastramento de um novo cartão. Isto é recomendado quando o comerciante gerencia a exibição dos cartões salvos do usuário a partir de sua própria UI, e só precisa da DEUNA para lidar com o formulário de inscrição do cartão.

onlyCardEnrollment substitui o resultado da tabela de prioridades acima: mesmo que um userToken ou um ativo user_authentication_flow normalmente mostrariam cartões salvos, esse sinalizador os força a permanecer ocultos durante aquela sessão.

Exemplo — configuração do Vault Widget WebSDK:

await DeunaSDK.initElements({
  orderToken: "<ORDER_TOKEN>",
  userToken: "<AUTHENTICATION_TOKEN>",
  userInfo: { /* ... */ },
  behavior: {
    onlyCardEnrollment: true,
    // ...other behavior overrides
  },
  callbacks: { /* ... */ },
  },
});

Ativar salvamento de cartão#

Além de decidir se um usuário finaliza a compra como convidado ou como usuário autenticado, você pode configurar como o salvamento do cartão se comporta durante o pagamento.

Ambas as variáveis também são configuradas dentro widgets_general_config.user_experience:

{
  "widgets_general_config": {
    "user_experience": {
      "show_saved_cards_flow": true,
      "default_card_flow": true
    }
  }
}

Ativar salvamento de cartão#

É possível exibir uma caixa de seleção que permite ao comprador decidir se deseja salvar seu cartão na finalização da compra. Esta opção é útil em fluxos de convidados.

O comportamento padrão é não exibir a caixa de seleção e salvar automaticamente o cartão para melhorar a conversão.

Ampliar

Permitir exclusão do cartão#

Controla se os compradores podem excluir cartões salvos no Widget do Cofre. Recomendado para modelos de assinatura e faturamento recorrente para evitar a remoção acidental da forma de pagamento e a rotatividade involuntária.

Configurar dentro widgets_general_config.user_experience:

{
  "widgets_general_config": {
    "user_experience": {
      "allow_card_deletion": false
    }
  }
}

Comportamento da IU

Estilos visuais#

Personalize seu widget usando CustomStyle.

Adapte a experiência visual dos seus clientes às diretrizes da sua marca.