Aller au contenu principal
Sur cette page
Méthode d’intégration

Configurez une expérience de paiement DEUNA dans VTEX.

Installez le connecteur certifié, configurez les conditions de paiement et enrichissez le checkout VTEX avec DEUNA Widget.

Interface
Checkout VTEX avec DEUNA Widget
Mode de déploiement
Configuration de l’application et du connecteur VTEX
Idéal pour
Marchands VTEX utilisant l’orchestration des paiements DEUNA

Comment configurer les conditions commerciales VTEX avec V2 Widget#

VTEX permet aux commerçants d'utiliser les conditions commerciales pour regrouper un ensemble de produits (SKU) sur la plateforme. Grâce à ces conditions commerciales, VTEX permet au commerçant de décider par quelle condition de paiement (méthode de paiement) traiter la transaction de l'acheteur.

Avantages

VTEX permet de configurer différents fournisseurs de paiement et de les associer à des conditions de paiement dans lesquelles vous pouvez activer des conditions commerciales spécifiques (SKUs). Toutefois, ce processus peut présenter des défis :

  1. Limites des fournisseurs: Certains fournisseurs de paiement que vous utilisez pourraient ne pas être disponibles dans les connecteurs VTEX. Par conséquent, vous ne pouviez pas associer une condition commerciale à un fournisseur non disponible.
  2. Activation de paiement intégrée : Contrairement à VTEX, qui ne supporte pas actuellement l'utilisation des conditions de paiement dans les modalités intégrées (application de paiement) en raison de limitations dans son protocole de paiement, notre Widget permet d'intégrer ces fonctionnalités, offrant une expérience de paiement améliorée.
  3. Expérience en matière de paiement Tous les fournisseurs de VTEX n'offrent pas une expérience de caisse intégrée. La configuration de différents fournisseurs entraîne l'apparition de plusieurs boutons dans la caisse, ce qui peut confondre l'acheteur et affecter négativement l'expérience d'achat.
  4. Configuration simple: Avec le widget DEUNA, vous n'avez qu'à configurer une condition de paiement (DeunaNow) pour gérer toutes les conditions commerciales souhaitées à partir d'une condition de paiement unique.

Avec ces avantages, le Widget DEUNA améliore non seulement la fonctionnalité et l'efficacité de l'utilisation de VTEX, mais améliore également l'expérience d'achat de vos clients.

Exigences

  1. Installation configurée dans DEUNA
  2. Titres de créance VTEX fournis à l'équipe DEUNA
  3. D'identification PSP pour effectuer la configuration dans DEUNA

Étapes

  1. Configurer les PSP dans DEUNA pour des conditions commerciales
  2. Configurer le mode de paiement dans VTEX
  3. Configurer les règles de DEUNA pour traiter les acomptes avec des conditions commerciales

Étape 1: Configuration PSP en DEUNA pour les conditions commerciales

Avant d'effectuer la configuration dans votre boutique VTEX, il est important que vous puissiez configurer votre PSP dans DEUNA. Pour ce faire, vous devez suivre les étapes suivantes :

  • Saisissez votre administrateur DEUNA avec votre nom d'utilisateur et votre mot de passe. Sélectionnez ensuite le module "Se connecter"
  • Ajoutez vos identifiants PSP et configurez. Pour soutenir les conditions commerciales, nous vous suggérons d'ajouter plusieurs connexions de votre PSP en utilisant la nomenclature suivante:
Plain text
PSP Name - VTEX commercial condition name

Nomenclature détaillée

  • Nom du PSP : Nom du PSP que vous configurez. Exemple : Mercadopago
  • Nom commercial de la condition VTEX: Le nom qui identifie la condition commerciale que vous utiliserez, qui est construit par : nom de condition + pourcentage d'activation de la règle dans VTEX. Exemple : articles fixes > 20 %

Dans le tutoriel suivant, nous vous montrons comment effectuer cette configuration

DEUNA Admin - Configuration PSP pour l'état commercial en VTEX

Une fois cette configuration terminée, vous pouvez passer à l'étape suivante.

Étape 2: Configuration du mode de paiement dans VTEX

Pour que DEUNA identifie correctement les conditions commerciales dans VTEX, il est essentiel d'effectuer une configuration appropriée dans le mode de paiement DeunaNow. Ici nous vous expliquons le processus étape par étape, y compris comment utiliser la nomenclature correcte pour que votre widget supporte des acomptes avec des conditions commerciales

  • Ajouter un mode de paiement : Ajouter la méthode de paiement DeunaNow. Nous vous recommandons d'utiliser un nom descriptif qui identifie le nom de la règle que vous utiliserez. (Dans la table ci-jointe vous pouvez trouver un exemple de nom de règle)
  • Activer les acomptes pour l'état de paiement : Une fois que vous ajoutez le mode de paiement DeunaNow, assignez un connecteur et ajoutez le nom. Vous devez appuyer sur l'option "Nombre total d'acomptes".
  • Identificateur associé: Dans le champ « Nombre total d'acomptes », vous devez saisir une combinaison du nombre maximal d'acomptes autorisés avec l'identificateur de condition commerciale joint au tableau, selon la nomenclature suivante:
Plain text
[Maximum number of installments to show in widget],[Commercial condition identifier]

Nomenclature détaillée

  • Nombre maximal d'acomptes à afficher dans le widget: Correspond à la limite d'acomptes qui a été configurée dans l'administrateur DEUNA. Ce numéro définit jusqu'à combien de versements peuvent être offerts au client pendant le processus d'achat.
  • Identification commerciale de l'état: C'est un numéro attribué à chaque condition commerciale, établi dans le tableau d'identification ci-joint. Cet identifiant permet à DEUNA de reconnaître la condition commerciale spécifique appliquée à la transaction.

Exemple pratique

Si vous avez une condition commerciale qui permet des paiements jusqu'à 6 versements et est associé à l'identificateur 50 (éléments stationnaires > 20%) de la table des conditions, vous devez entrer dans le champ des versements:

Plain text
6, 50

Ce format garantit que DEUNA reconnaît à la fois le nombre maximal d'acomptes autorisés et la condition commerciale applicable, facilitant le processus de paiement et assurant une application correcte des politiques commerciales de votre magasin.

Dans le tutoriel suivant, nous vous montrons comment effectuer cette configuration

Important: La configuration d'acompte effectuée ci-dessus est référente de sorte que notre widget détecte la configuration. L'identificateur de condition commerciale configuré dans VTEX ne sera pas montré à l'acheteur.

Étape 3: Configuration des règles dans DEUNA pour traiter les acomptes avec conditions commerciales

Après avoir configuré le mode de paiement DeunaNow avec l'identificateur de condition commerciale à l'étape précédente, il est extrêmement important de configurer les règles dans l'administrateur de DEUNA. Avec cela, notre widget sera en mesure d'identifier par quelle condition commerciale effectuer le processus de paiement. Pour effectuer la configuration des règles dans DEUNA pour traiter les acomptes avec des conditions commerciales, vous devez faire ce qui suit :

  • Saisissez l'administrateur DEUNA avec votre nom d'utilisateur et votre mot de passe, et sélectionnez le module "Stratégies de paiement"
  • Appuyez sur le bouton « Créer une règle spécifique » et ajoutez un nom à la règle. Nous vous suggérons d'utiliser un nom qui vous permet d'identifier la règle de la condition commerciale. Appuyez ensuite sur le bouton "Aller à l'étape suivante"
  • Dans la section "Ajouter des conditions", vous devez appuyer sur le bouton "Ajouter des conditions +" et vous devez chercher l'option "Métadonnées"
  • Dans Métadonnées, il est important d'utiliser le nom de variable "commercial condition", le format "Text", Propriétés: "({}) Contient" et d'ajouter le numéro d'identificateur que vous avez utilisé à l'étape précédente. Exemple : 50 (correspondant aux éléments fixes > 20 %)
  • Une fois que vous ajoutez ces informations, appuyez sur le bouton "Enregistrer les métadonnées" et puis sur le bouton "Enregistrer" pour passer à l'étape suivante.
  • Une fois que vous revenez à la section "Créer une règle spécifique" appuyez sur le bouton "Aller à l'étape suivante"
  • Dans la section "Définir l'ordre de traitement des transactions", appuyez sur le bouton "Modifier le routage", sélectionnez le traitement (connection) que vous avez configuré pour l'état commercial. Exemple : « Mercadopago - Stationnaire spécial ».
  • Sélectionnez la règle de traitement et appuyez sur le bouton "Enregistrer". Avec cela, vous avez fini de configurer la règle spécifique pour votre condition commerciale.

Dans le tutoriel suivant, nous vous montrons comment effectuer cette configuration

Configurer la règle dans DEUNA pour supporter des versements avec un état commercial VTEX


Tableau exemple pour les conditions commerciales avec identifiant pour DEUNA#

Dans le tableau suivant, nous vous fournissons un exemple de noms de conditions commerciales, avec un identifiant suggéré. Le nom de la règle de condition commerciale se réfère au nom de la condition commerciale que vous avez dans VTEX, d'autre part, nous suggérons d'utiliser un nombre supérieur ou égal à 49 pour pouvoir l'identifier dans DEUNA.

Ce numéro sera celui que vous configurez dans l'administrateur DEUNA lors de la configuration des règles de traitement pour le PSP.

Nous ajoutons le tableau suivant avec des exemples suggérés pour identifier vos conditions commerciales, où:

  • Nom de la règle de l'état commercial: C'est le nom de la condition commerciale suivie de la règle que vous configurez dans le mode de paiement qui est valide
  • Identifiant: Identification utilisée par le widget DEUNA pour identifier quelle condition commerciale doit être utilisée. Cet identifiant sera utilisé lorsque vous effectuerez l'étape de configuration d'Installation avec le support des conditions commerciales VTEX. L'identificateur doit être supérieur ou égal au numéro 49
#Nom de la règle de l'état commercial (exemple)Identifiant
1postes techniques > 10 %49
2articles fixes > 20 %50
3articles fixes > 10 %58
4d'articles de vêtements > 1 %51
5articles spéciaux fixes > 20 %52
6vêtements > 20 %53
7Produits d'épicerie > 20 %54
8articles de soins personnels > 20%55
9Articles de carte cadeau > 20%56
10prévention des éléments technologiques > 1%57

Qu'est-ce qu'une condition commerciale dans VTEX?#

Une condition commerciale dans VTEX est une ressource qui permet aux commerçants de regrouper différents produits (SKUs) pour définir des scénarios de paiement spécifiques (conditions de paiement) sur la plateforme. Lorsque vous configurez votre condition de paiement avec des conditions de paiement spéciales, vous pouvez activer la condition commerciale. VTEX vous permet d'établir, en fonction d'un pourcentage du total du panier, quand cette condition commerciale sera activée. Par exemple, considérons un magasin VTEX où vous vendez les produits suivants :

Nom du produitValeur
T-shirt1000
Pantalons1500
Chemise1200
Robe2500
Téléphone portable5000
Ordinateur10000
Comprimé6000

En tant que propriétaire du magasin, vous pourriez vouloir établir des conditions commerciales qui regroupent les produits dans des catégories comme Vêtements et Technologie. De plus, vous pourriez vouloir que les transactions de vêtements soient traitées par MercadoPago (état de paiement) et la technologie par Stripe (état de paiement).

Vous pouvez configurer les règles comme suit : si le total des produits Vêtements dépasse 20% du total du panier, alors ils seront traités par MercadoPago. De même, si le total des produits technologiques dépasse 20% du total des chariots, ils seront transformés par Stripe. Voici comment il serait configuré :

#État commercial dans l'état de paiement VTEXProduits associésRésultat
1Vêtements > 20% du total du chariotT-shirt, Pantalon, Chemise, RobeProcess by MercadoPago
2Technologie > 20% du total du panierTéléphone portable, Ordinateur, CompriméProcess by Stripe

Exemple de scénarios:

  • Scénario 1: Un acheteur achète 10 t-shirts et 10 pantalons, et achète également 1 téléphone portable.
ProduitQuantitéÉtat commercial à laquelle elle appartientTotal
T-shirts10Vêtements10000
Pantalons10Vêtements15000
Téléphone portable1Technologie5000
CART TOTAL30000

L'état commercial de la Vêtement, qui dépasse 80% du total du chariot, sera traité par MercadoPago. Par contre, la condition Technologie, qui représente 16% du total, n'est pas activée.

  • Scénario 2 : Un acheteur achète 1 téléphone portable, 1 ordinateur, 1 tablette et 1 t-shirt.
ProduitQuantitéÉtat commercial à laquelle elle appartientTotal
Téléphone portable1Technologie5000
Ordinateur1Technologie10000
Comprimé1Technologie6000
T-shirt1Vêtements1000
CART TOTAL

La technologie commerciale condition dépasse 90% du total du chariot et sera traitée par Stripe, tandis que Vêtements, qui ne représente que 4,55%, n'est pas activé.

En résumé, les conditions commerciales dans VTEX permettent au marchand de traiter les transactions par des conditions de paiement différentes (méthodes de paiement comme MercadoPago ou Stripe, etc.), selon la configuration faite sur la base du pourcentage total du panier. Cela facilite la gestion des différents PSP selon la configuration du paiement.