L’interface Data Enrichment permet aux marchands de fournir des renseignements supplémentaires ou manquants pour les transactions traitées par Nuvei (à l’interne) et des renseignements complets pour les transactions traitées par un autre fournisseur de services de paiement et non par l’intermédiaire de l’API Nuvei (à l’externe). Ces renseignements sont ensuite transmis à Visa Resolve Online (VROL), la plateforme de gestion des différends de Visa.
Ces renseignements complémentaires sont ensuite combinés avec les données de transaction correspondantes puis mises à la disposition de l’émetteur du litige. Grâce à ce haut niveau de détail, la personne qui soumet le différend peut prendre une décision plus éclairée quant à la possibilité de faire une demande pour différend et, le cas échéant, quant au type de demande pour différend. Ces données peuvent être utilisées pour toutes les catégories de différends, notamment les rétrofacturations et les fraudes. En temps normal, ces renseignements détaillés sur les achats et les comptes clients ne sont pas transmis dans les premières étapes du processus de différend. Cependant, il est possible d’éviter certaines contestations inutiles ou non valides en transmettant ces renseignements et la logique derrière la décision de VROL à la personne chargée de l’analyse du différend en amont, avant qu’une décision soit prise quant à l’ouverture d’un différend.
L’interface comprend deux onglets :
- Upload
- View Uploaded Files
Onglet Upload
Cet onglet sert à téléverser les fichiers CSV contenant les données sur les transactions.
Directives pour le téléversement
Vous pouvez télécharger un modèle de fichier CSV en cliquant sur Download Sample CSV File. Vous pourrez ensuite vous servir de ce modèle pour téléverser vos données en vue de leur validation. Le système repère automatiquement votre secteur et détermine si les transactions ont été traitées à l’interne ou à l’externe. Le modèle de fichier correspondant est ensuite téléchargé.
Le modèle de fichier comprend ce qui suit :
- Paramètres pertinents
- Exemples de données
- Type de champ (indique s’il peut contenir ou non des valeurs multiples)
- Type de paramètre (obligatoire ou facultatif)
- Structure de chaque paramètre
- Description de chaque paramètre
Structure du fichier
Les paramètres des catégories suivantes sont considérés comme des « listes ». Cela veut dire qu’ils peuvent contenir plusieurs valeurs.
- Custom fields
- Hotel info
- Passenger info
- Flight info
- Products
- Consumer interactions
Si vous décidez d’entrer plusieurs valeurs dans un même paramètre, vous devez séparer ces valeurs par une barre verticale (« | »). Vous devez suivre le même ordre dans toutes vos descriptions. Vous devez utiliser les barres verticales même si vous n’entrez aucune valeur pour un article donné.
——————————————————-
Voici un exemple :
Imaginons une commande qui comprend un t-shirt et un pantalon. Pour le t-shirt, nous avons un nom, une description, un UGS et une quantité, tandis que pour le pantalon, nous n’avons qu’un nom et une quantité. La ligne ressemblera à ce qui suit :
Nom du produit, Description du produit, UGS du produit, Quantité du produit
T-shirt noir | Pantalon, Description du t-shirt | , 567787|, 1|1
——————————————————-
Vous pouvez utiliser des espaces, mais ce n’est pas nécessaire.
Les contraintes de longueur et de format s’appliquent à chaque article de façon indépendante.
Les autres paramètres sont des paramètres dits « ordinaires » : ils ne peuvent contenir qu’une seule valeur.
Répétition du téléversement
Si, après avoir téléversé un fichier une première fois, vous devez le téléverser à nouveau (soit parce qu’il y a eu une erreur la première fois ou parce que vous avez modifié certaines données), faites attention à ce qui suit :
- Les champs portant la mention « obligatoire » ne peuvent pas être remplacés.
- L’envoi de nouveaux paramètres entraînera le remplacement des paramètres précédents.
- Imaginons que dans votre premier envoi, vous aviez entré « t-shirt » et « pantalon » dans le paramètre du nom du produit. Si vous souhaitez ajouter des chaussures, votre nouveau fichier devra comprendre les trois articles, pas seulement le nouveau. Si votre nouveau fichier ne comprend que les souliers, le t-shirt et le pantalon seront remplacés par cette nouvelle valeur.
- Si vous laissez un paramètre vide, la valeur entrée précédemment demeurera inchangée.
- Nous vous recommandons donc de n’entrer que les champs qui doivent être modifiés. Les champs qui ne sont pas inclus dans le nouveau téléversement ne seront pas modifiés.
Validations
Une fois que votre fichier CSV est téléversé sur le serveur, il passe par une validation pour garantir ce qui suit :
- Le fichier porte une extension CSV, et le format est délimité par des virgules.
- La taille du fichier ne dépasse pas 2 Mo.
- Il n’y a pas d’erreurs techniques (comme des erreurs de connexion).
- Il répond aux exigences de sécurité (Nuvei recourt à un service externe pour détecter les logiciels malveillants dans les fichiers).
Si la validation de votre fichier échoue, vous en verrez la raison dans la fenêtre contextuelle de téléversement.
Téléversement de fichiers par lot
Voici comment téléverser un lot de fichiers :
- Dans la barre de menus, cliquez sur Risk > Pre-chargebacks > Data Enrichment. Vous accédez ainsi à la page Data Enrichment.
- Sélectionnez le client dans le menu déroulant Client Name.
- Sélectionnez le type de transactions que vous souhaitez téléverser : interne ou externe.
-
- Interne – Pour téléverser des fichiers contenant des renseignements supplémentaires sur des transactions traitées par Nuvei.
- Externe – Pour téléverser des fichiers contenant des renseignements sur des transactions traitées par d’autres fournisseurs de services de paiement.
Une fois la sélection faite, la section Upload CSV File s’affiche.
-
- Dans la section Upload CSV File, sélectionnez le fichier à téléverser ou faites-le glisser dans la case prévue à cet effet. Vous verrez ensuite apparaître une fenêtre vous indiquant la progression du téléversement.
- Une fois le téléversement terminé, cliquez sur Close. Vous verrez la liste des fichiers téléversés sous la section Upload CSV File.
Le bouton vous permet retirer un fichier de la liste de fichiers à téléverser sur le serveur. - Pour procéder au téléversement, cliquez sur Continue Processing. Le système vous redirige ensuite vers l’onglet View Uploaded Files.
Onglet View Uploaded Files
L’onglet View Uploaded Files vous présente un tableau répertoriant les fichiers CSV qui ont été téléversés.
Ces fichiers sont traités sur les serveurs de Nuvei. Cet onglet permet une deuxième validation de l’intégrité des données.
Vous pouvez filtrer les résultats par période puis cliquer sur .
Voici une description des colonnes de ce tableau :
Colonne du tableau | Description |
---|---|
Batch ID | Identifiant de lot généré par le service après le téléversement du fichier. |
Uploaded Rows | Nombre de lignes téléversées avec succès à partir du fichier CSV. |
Upload Status | État du téléversement du fichier : Successfully Uploaded – Les transactions ont été téléversées dans le système. Partially Uploaded (has errors) – Certaines transactions ont été téléversées avec succès, d’autres non. In Process – La deuxième validation et le téléversement sont toujours en cours. Failed to upload due to temporary technical problems – Ce problème est habituellement causé par une erreur de connexion. Nous vous recommandons d’attendre quelques minutes puis de réessayer. Failed Format Validation – Des colonnes non valides ou manquantes entraînent une erreur de format. |
Errors | Si le téléversement d’un fichier a échoué en raison d’un problème technique, vous verrez l’icône dans la colonne Errors. Si vous cliquez sur l’icône, cela téléchargera un fichier contenant seulement les lignes erronées, assorties d’une description d’erreur dans une nouvelle colonne intitulée Error Description. Vous devrez alors corriger les erreurs avant de téléverser le fichier à nouveau. |
File Name | Nom du fichier enregistré par le marchand sur son appareil. Les fichiers ayant récemment été téléversés (au cours des 24 dernières heures) sont indiqués par un point bleu. |
Client Name | Nom du client. |
Upload Date | Date du téléversement. Par défaut, les téléversements sont triés du plus récent au plus ancien. L’ordre peut être modifié à l’aide des flèches. |
File Size | Taille du fichier. |