Aller au contenu principal
Sur cette page

Les paramètres suivants vous permettent de personnaliser le comportement et l'apparence du paiement en fonction des besoins spécifiques de chaque commerçant.

Langue#

La langue de l'interface de paiement est automatiquement configurée en fonction du pays dans lequel votre entreprise opère.

Ce paramètre vise à garantir une expérience localisée aux acheteurs, en réduisant les frictions et en améliorant les taux de conversion.

  • Le langage est défini par la tokenisation des commandes.
  • La langue peut être spécifiée dynamiquement pour chaque commande.

URL de base#

Si vous souhaitez personnaliser une URL de base spécifique pour vos liens de paiement, vous pouvez la demander à notre équipe d'assistance. Cette personnalisation vous permet d'adapter l'expérience à votre identité de marque.

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

Activer l'authentification des utilisateurs#

DEUNA vous permet de configurer si vos acheteurs effectuent leur paiement en tant qu'invités ou en tant qu'utilisateurs authentifiés, avec accès à leurs cartes enregistrées et aux données d'achats précédentes. Ce comportement est contrôlé par deux variables :

VariableTapezDescriptif
user_authentication_flowbooleanActive le flux d'utilisateurs authentifiés (connexion, OTP, cartes enregistrées).
init_with_guest_userbooleanActive le flux des utilisateurs invités (pas de connexion).

Les deux variables sont configurées à l'intérieur widgets_general_config.user_experience lors de la création ou de la mise à jour de votre configuration marchand :

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

Comment décide-t-on si un utilisateur voit le flux authentifié ?

Si vous définissez user_authentication_flow: true, DEUNA détermine quel utilisateur afficher (et donc quelles cartes enregistrées) selon un ordre de priorité. Une valeur définie à un niveau supérieur remplace toujours les niveaux en dessous :

PrioritéSourceDescriptif
1 (le plus élevé)Paramètre de requête userTokenSi le commerçant envoie explicitement un userToken lors de l'initialisation du widget, cet utilisateur est utilisé quelle que soit toute autre configuration.
2Configuration marchandSi non userToken est envoyée, la configuration définie dans widgets_general_config.user_experience est utilisé.
3 (le plus bas)E-mail de commande/facturationS'il n'y a pas userToken et aucune configuration applicable, la décision est basée uniquement sur l'e-mail reçu dans la commande ou les données de facturation.

Exemple — initialisation avec un expliciteuserToken:

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

Remplacement à l'initialisation : onlyCardEnrollment

Paramètres envoyés à l'intérieur behavior lors de l'initialisation du WebSDK vous permettent de remplacer certains flux définis dans votre configuration marchand, sans modifier cette configuration elle-même.

onlyCardEnrollment masque les cartes enregistrées d'un utilisateur authentifié, permettant uniquement l'enregistrement d'une nouvelle carte. Ceci est recommandé lorsque le commerçant gère l'affichage des cartes enregistrées de l'utilisateur depuis sa propre interface utilisateur et n'a besoin que de DEUNA pour gérer le formulaire d'inscription de la carte.

onlyCardEnrollment annule le résultat du tableau de priorités ci-dessus : même si un userToken ou un actif user_authentication_flow afficherait normalement les cartes enregistrées, ce drapeau les oblige à rester cachés pendant cette session.

Autorisateur externe (userToken)OTP (user_authentication_flow)onlyCardEnrollmentCartes enregistrées visibles ?
✅❌❌✅
✅❌✅❌
❌✅❌✅
❌✅✅❌

Exemple — Configuration du WebSDK du widget Vault :

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

Activer l'enregistrement de la carte#

En plus de décider si un utilisateur paie en tant qu'invité ou en tant qu'utilisateur authentifié, vous pouvez configurer le comportement de l'enregistrement de la carte lors du paiement.

VariableTapezDescriptif
show_saved_cards_flowbooleanAffiche un case à cocher qui permet à l'acheteur de décider s'il souhaite enregistrer sa carte lors du paiement. Lorsqu'il est désactivé (false, valeur par défaut), la carte est enregistrée automatiquement sans demande, ce qui améliore la conversion sur les futurs achats.
default_card_flowbooleanAffiche une case à cocher supplémentaire permettant à l'utilisateur de décider si cette carte doit être marquée comme par défaut pour de futurs achats. Désactivé par défaut.

Les deux variables sont également configurées à l'intérieur widgets_general_config.user_experience:

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

Activer l'enregistrement de la carte#

Il est possible d'afficher une case à cocher qui permet à l'acheteur de décider s'il souhaite enregistrer sa carte lors du paiement. Cette option est utile dans les flux d’invités.

Le comportement par défaut consiste à ne pas afficher la case à cocher et à enregistrer automatiquement la carte pour améliorer la conversion.

Autoriser la suppression de la carte#

Contrôle si les acheteurs peuvent supprimer les cartes enregistrées dans le Widget de coffre-fort. Recommandé pour les modèles d'abonnement et de facturation récurrente afin d'éviter la suppression accidentelle du mode de paiement et le désabonnement involontaire.

VariableTapezPar défautDescriptif
allow_card_deletionbooleantrueDétermine si les acheteurs peuvent supprimer des cartes. Quand false, toutes les actions de suppression sont masquées.

Configurer à l'intérieur widgets_general_config.user_experience:

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

Comportement de l'interface utilisateur

ÉtatCartes activesCartes expiréesCarte par défautVue d'une seule carte
false (Désactivé)Masque « Supprimer » du menu (seul « Définir par défaut » est affiché).Masque l'icône de la corbeille.Masque entièrement le menu d’actions pour éviter les popovers vides.Masque le bouton Supprimer.
true or omis (par défaut)Suppression standard disponible dans le menu.Icône poubelle visible et active.Suppression standard disponible dans le menu.Bouton Supprimer visible et actif.

Styles visuels#

Personnalisez votre widget à l'aide de CustomStyle.

Adaptez l’expérience visuelle de vos clients aux directives de votre marque.