Traitement par lots
Dans le Traitement par lots section, vous pouvez exécuter des opérations groupées pour :
- Remboursements: Renvoie le montant total ou partiel d'une transaction.
- Captures de transactions: Confirmer la conservation des fonds précédemment autorisés.
- Transaction annulée: Annulez une transaction autorisée avant que l'argent ne soit capturé.
Cet outil facilite le chargement d'un grand volume de transactions en téléchargeant un fichier CSV.
1. Téléchargez le modèle#
Pour garantir que les données chargées sont correctes et suivent le format requis, le système propose un exemple de fichier CSV pour chaque opération (modèle). Ce modèle contient les champs nécessaires pour chaque opération prise en charge.
- Accédez à la section Traitement par lots.
- Téléchargez le modèle CSV correspondant à l'opération que vous souhaitez exécuter (remboursement, capture ou annulation).
- Complétez le modèle avec les données des transactions que vous souhaitez traiter. Assurez-vous que les valeurs saisies respectent le format de chaque colonne.
Remboursements
Le tableau suivant présente le modèle de remboursement :
| Nom du champ | Tapez | Descriptif |
|---|---|---|
| batch_id | en-tête | Identifiant unique attribué par l'utilisateur, celui-ci ne peut être répété par lot. (Numérique) |
| transaction_type | en-tête | Dans le cas du modèle de remboursement, la valeur doit être refund |
| raison | en-tête | L'utilisateur peut préciser, par lot, le motif de l'opération. (par exemple, annulation de vol) |
| transaction_id | rangée | Identifiant unique de la transaction à rembourser. |
| monnaie | rangée | Devise de transaction (par exemple, USD, MXN). |
| amount_to_refund | rangée | Montant à rembourser (partiel ou total). La valeur en centimes doit être incluse, sans virgules ni points. (par exemple, 1226,00 USD, il faut saisir le montant 122600) |
Captures
Le tableau suivant définit le modèle de capture de paiement :
| Nom du champ | Tapez | Descriptif |
|---|---|---|
| batch_id | en-tête | Identifiant unique attribué par l'utilisateur, celui-ci ne peut être répété par lot. (Numérique) |
| transaction_type | en-tête | Dans le cas du modèle de capture, la valeur doit être capture |
| transaction_id | rangée | Identifiant unique de la transaction à rembourser. |
| monnaie | rangée | Devise de transaction (par exemple, USD, MXN). |
| amount_to_refund | rangée | Montant à rembourser (partiel ou total). La valeur en centimes doit être incluse, sans virgules ni points. (par exemple, 1226,00 USD, il faut saisir le montant 122600) |
Vides
Le tableau suivant définit le modèle pour les paiements annulés :
| Nom du champ | Tapez | Descriptif |
|---|---|---|
| batch_id | en-tête | Identifiant unique attribué par l'utilisateur, celui-ci ne peut être répété par lot. (Numérique) |
| transaction_type | en-tête | Dans le cas du modèle void, la valeur doit être void |
| transaction_id | rangée | Identifiant unique de la transaction à rembourser. |
2. Téléchargez le fichier#
Téléchargez le fichier CSV complété dans l'administrateur DEUNA :
- Aller à Traitement par lots.
- Cliquez Télécharger un lot
- Attribuez un nom au téléchargement de fichier.
- Téléchargez le fichier CSV
- Cliquez Valider.
3. Examiner les résultats du lot#
Les statuts de fichiers possibles sont les suivants :
| Statut | Descriptif | Action requise |
|---|---|---|
| Validation | Le fichier a été téléchargé et est en cours de validation. | Wait. |
| À résoudre | Le fichier contient des erreurs qui nécessitent une intervention manuelle. | Corrigez les erreurs et téléchargez à nouveau le fichier. |
| Rejeté | La validation du fichier a échoué. | Vérifiez et corrigez les erreurs indiquées, puis téléchargez à nouveau le fichier. |
| Traitement | Le fichier a passé la validation et est en cours de traitement. | Attendez la fin du traitement. |
| Terminé | Le traitement du fichier est terminé. | Examinez les résultats dans le fichier de réponses. |
Erreurs de fichier
Téléchargez un fichier avec les détails de l'erreur par fichier ou par transaction si le fichier contient des erreurs.
Le tableau suivant documente les erreurs possibles et leurs catégories :
| Catégorie | Nom de l'erreur | Descriptif | Code d'erreur |
|---|---|---|---|
| Mauvais format de fichier | Ligne vide | Champ vide obligatoire pour exécuter l'opération. | BT1 |
| Mauvais arguments de fichier | Ligne vide | Champ vide obligatoire pour exécuter l'opération. | BT2 |
| Mauvais format de fichier | Mauvais format de ligne | Mauvais format dans une colonne. | BT3 |
| Mauvais format de fichier | MissingBatchIDHeader | L’ID du lot doit être inclus dans l’en-tête. | BT4 |
| Mauvais format de fichier | MissingTransactionTypeHeader | Le type de transaction doit être inclus dans l'en-tête. | BT5 |
| Mauvais format de fichier | LigneVideManquante | La deuxième ligne du fichier doit être vide. Il est recommandé de télécharger le modèle. | BT6 |
| Mauvais format de fichier | MissingDataRowsHeader | Les en-têtes de modèle requis doivent être inclus. | BT7 |
| Mauvais format de fichier | MissingOrderTokenHeader | L'ID de transaction doit être inclus dans l'en-tête. Il est recommandé de télécharger le modèle. | BT8 |
| Mauvais format de fichier | MissingCurrencyHeader | La devise doit être incluse dans l’en-tête. Il est recommandé de télécharger le modèle. | BT9 |
| Mauvais format de fichier | MissingAmountToCaptureHeader | amount_to_capture doit être inclus dans l’en-tête. Il est recommandé de télécharger le modèle. | BT10 |
| Mauvais format de fichier | MissingAmountToRefundHeader | amount_to_refund doit être inclus dans l’en-tête. Il est recommandé de télécharger le modèle. | BT11 |
| Mauvais arguments de fichier | ID de lot invalide | L'ID de lot n'est pas valide. | BT12 |
| Mauvais arguments de fichier | InvalidTransactionType | Le type de transaction saisi n'est pas valide. | BT13 |
| Mauvais format de fichier | Jeton de commande invalide | L'ID de transaction saisi n'est pas valide. | BT14 |
| Mauvais format de fichier | Devise invalide | La devise saisie n'est pas valide. | BT15 |
| Mauvais format de fichier | Montant invalide | Le montant saisi n'est pas valide. | BT16 |
| Mauvais format de fichier | CurrencyHeaderShouldBeEmpty | Le fichier de modèle vide ne doit pas contenir de devise dans l'en-tête. Il est recommandé de télécharger le modèle. | BT17 |
| Mauvais format de fichier | CurrencyShouldBeEmpty | Le fichier de modèle vide ne doit pas contenir de valeur monétaire dans l'en-tête. Il est recommandé de télécharger le modèle. | BT18 |
| Mauvais format de fichier | AmountHeaderShouldBeEmpty | Le fichier de modèle d'annulation ne doit pas contenir de montant dans l'en-tête. Il est recommandé de télécharger le modèle. | BT19 |
| Mauvais format de fichier | Le montant devrait être vide | Le fichier de modèle vide ne doit pas contenir de valeur de montant dans l'en-tête. Il est recommandé de télécharger le modèle. | BT20 |