L’interface Bulk Upload permet aux marchands de téléverser un fichier CSV contenant les transactions existantes, puis de les traiter au moyen des actions par lot suivantes : remboursement, règlement, annulation, paiement, ajout à une liste et retrait d’une liste.
Ce rapport est offert aux marchands ayant les rôles suivants : Management et Operations_Actions.
Cette interface ne concerne que les transactions traitées par l’intermédiaire de Nuvei et les types de transactions de référence suivants : vente, autorisation et règlement.
Lignes directrices de téléversement de fichiers
Cliquez sur le lien Download Sample CSV File pour télécharger un exemple de fichier CSV afin de savoir comment préparer le vôtre.
L’exemple de fichier comprend ce qui suit :
- Transaction ID – Numéro de transaction de Nuvei.
- Amount – Montant de la transaction visée par votre action. Vous n’avez pas besoin de préciser la devise.
- Copy of Client Unique ID – Valeur TRUE ou FALSE.
- Si vous entrez la valeur TRUE, Nuvei extrait l’identifiant unique du client associé à la transaction initiale.
- La valeur FALSE fait en sorte que ce champ demeure vide.
- Lorsque vous téléversez votre fichier CSV, gardez ces lignes directrices en tête :
- Chaque fichier CSV devrait contenir un seul type d’action.
- Vous ne pouvez télécharger qu’un seul fichier à la fois.
Validation du fichier
Remboursement, règlement, annulation ou paiement
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.
- Le fichier ne contient pas plus de 200 transactions.
- La colonne Action Amount ne contient aucune valeur négative.
- Les trois premières colonnes ne contiennent aucune cellule vide.
- Aucun numéro de transaction n’apparaît en double.
- Les colonnes Transaction ID et Amount ne contiennent aucun texte.
Ajout à une liste ou retrait d’une liste
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.
- Le fichier ne contient pas plus de 200 lignes.
- Le format est identique à celui de l’exemple de fichier pour chaque paramètre d’utilisateur.
Téléversement de fichiers par lot
Voici comment téléverser des transactions par lot :
- À partir de la barre de menus, sélectionnez Operations > Bulk Upload. La page Bulk Upload s’affiche.
- Sélectionnez l’action pertinente dans le menu déroulant Action Type.
- Si vous sélectionnez le type d’action Add to List ou Remove from List, vous devez également faire votre choix dans les menus déroulants ci-dessous :
- List Type – Indication que la transaction a été ajoutée à la liste des valeurs positives ou négatives ou retirée de cette liste (voir la rubrique Actions).
- User Parameters – Paramètre pour lequel vous souhaitez effectuer l’action.
- Billing Address
- Billing Phone
- IP
- Shipping Address
- Reason – Raison de l’action.
- [Facultatif] Client Name
- Dans la section Upload CSV File, sélectionnez le fichier à téléverser ou faites-le glisser dans la case prévue à cet effet.
Une fenêtre s’ouvre pour afficher la progression du téléversement.
Une fois que les fichiers sont validés, vous verrez un tableau des transactions téléversées.
Vous pouvez cliquer sur Export à tout moment pour télécharger ce tableau au format CSV, Excel ou PDF.
Tableau des enregistrements de fichiers CSV téléversés
Types d’actions – Remboursement, règlement, annulation ou paiement
Voici une description de chaque colonne affichée dans le tableau pour les types d’actions suivants : Refund, Settle, Void et Payout.
Colonne du tableau | Description | Remarques |
---|---|---|
Transaction ID | Numéro de la transaction pour laquelle vous effectuez l’action. | |
Validation | Colonne servant à vérifier ce qui suit :
| Valeurs possibles : Failure Success Un message d’échec avec la raison « Invalid transaction ID » signifie que :
|
Result | Résultat de la transaction. | Valeurs possibles : Approve Decline Error Filter error Affiché une fois que vous avez cliqué sur Submit. |
Amount | Montant de la transaction. | |
Action Amount | Montant à partir duquel sera effectuée votre action. | |
New Transaction ID | Numéro de transaction pour l’action (transaction liée). | Affiché une fois que vous avez cliqué sur Submit. |
Client Unique ID | Numéro de la transaction dans le système du marchand. | Cette valeur doit être unique. Affiché une fois que vous avez cliqué sur Submit. |
Colonne Validation
Le tableau suivant contient un résumé de la logique de validation lorsque vous comparez la colonne Action Amount à la colonne Amount.
Cas | Remboursement | Règlement | Paiement |
---|---|---|---|
Action Amount > Amount | Le service renvoie un message d’échec. | Le service renvoie un message d’échec. | Le service renvoie un message de réussite. |
Action Amount | Le service renvoie un message de réussite. | Le service renvoie un message de réussite. | Le service renvoie un message de réussite. |
Action Amount = Amount | Le service renvoie un message de réussite. | Le service renvoie un message de réussite. | Le service renvoie un message de réussite. |
Action Amount is empty | Le service renvoie un message de réussite. | Le service renvoie un message de réussite. | Le service renvoie un message de réussite. |
Nuvei rembourse le montant de la transaction. | Nuvei règle la transaction pour le montant indiqué. | Nuvei effectue un paiement pour le montant de la transaction. |
Pour l’action Void, le Control Panel ignore la colonne Amount dans le fichier CSV et présente le montant renvoyé par le service (montant de la transaction).
Colonne Action Amount
La colonne Action Amount permet au marchand d’apporter des corrections à la suite d’une validation échouée en raison du montant, comme décrit dans le tableau ci-dessus.
Une fois que vous avez corrigé les erreurs de validation dans la colonne Action Amount, le cas échéant, vous devez cliquer sur Validate.
La colonne Validation sera mise à jour après quelques instants.
Cliquez sur Submit pour traiter les transactions. Celles auxquelles vous avez attribué un nouveau numéro de transaction seront mises à jour dans le Rapport des transactions.
Types d’actions – Ajout à une liste ou retrait d’une liste
Ces actions au niveau de l’utilisateur permettent l’ajout ou le retrait en lots du paramètre sélectionné sur la liste d’autorisation ou la liste noire.
Voici une description de chaque colonne affichée dans le tableau pour les types d’actions suivants : Add to List et Remove from List
Colonne du tableau | Description |
---|---|
Value | Valeur entrée par le marchand dans le classeur Excel. |
Validation | Colonne servant à vérifier si la valeur entrée est valide. |
Invalidation Reason | Raison pour laquelle la valeur est non valide (le cas échéant). |
Colonne Value
La colonne Value permet au marchand de corriger tout échec de validation.
Une fois que vous avez résolu les erreurs de validation, vous devez cliquer sur Validate.
La colonne Validation sera mise à jour après quelques instants.
Cliquez sur Submit pour traiter les transactions.