Chargement des recharges

Send historical chargeback feedback to your anti-fraud providers through DEUNA.

Ask your DEUNA Technical Account Manager which environments, anti-fraud connections, file-delivery method, directories, and processing schedule are enabled for your merchant before sending production data. Not every dispute is evidence of fraud; include only the chargeback feedback agreed for the configured anti-fraud provider.

Comment fonctionnent les recharges#

DEUNA enables you to upload received chargeback feedback by email or SFTP and forward it to the configured anti-fraud provider. This feedback can help the provider improve its risk models.

Without timely outcome feedback, an anti-fraud provider has less information with which to identify similar fraud patterns.

Améliorer les résultats de la lutte contre la fraude

Découvrez comment les recharges améliorent votre stratégie antifraude.

Corriger "Faux négatifs"

Le principal travail du modèle est de marquer les transactions.

When a chargeback represents confirmed fraud, it is a strong false-negative signal: the model treated the transaction as acceptable, but the later outcome showed that it was fraudulent.

By uploading agreed chargeback feedback, the provider can use those outcomes to identify patterns it previously missed.

Reconnaissance du modèle de pouvoir

Le modèle antifraude analyse des milliers de points de données.

Lorsqu'elle reçoit une remise de charge, elle réévalue toutes les données associées à cette opération défaillante :

1. Quelle adresse e-mail a été utilisée?
2. Quelle empreinte ?
3. Quelle était l'adresse d'expédition ?
4. Quelle était l'heure de la journée ?

Le modèle peut maintenant trouver de nouveaux modèles cachés. Par exemple, il pourrait apprendre que les transactions d'une gamme de PI spécifique utilisant un nouveau courriel et l'achat de biens numériques sont soudainement beaucoup plus risqués qu'il ne le pensait initialement.

Active l'analyse de lien

Les fraudeurs réutilisent souvent des courriels, des appareils ou des adresses d'expédition.

Lorsque vous téléchargez un rechargement, le fournisseur lie cette fraude à chaque point de données de la transaction.

1. Avant: Le dispositif du fraudeur (Device_XYZ) a été considéré comme sûr.
2. Après: Vous téléchargez un rechargement pour cette transaction. Device_XYZ est désormais signalé comme étant à haut risque.
3. Résultat : La prochaine fois que toute transaction vient de Device_XYZ.

The provider can use the new signal when evaluating later transactions associated with the same risk indicators. The resulting decision still depends on the provider's model and your configured risk policy.

Garde le modèle à jour

Les tactiques de fraude changent constamment. Les modèles qui ont fonctionné pour les fraudeurs le mois dernier seront différents le mois prochain.

Le chargement des recharges le plus proche du temps réel est le seul moyen de s'assurer que le modèle d'apprentissage automatique s'adapte à ces nouvelles tactiques aussi rapidement qu'elles apparaissent.

En bref, le téléchargement des recharges n'est pas seulement une tâche administrative; c'est le cœur du processus d'apprentissage automatique.

C'est ainsi que vous apprenez activement au système à devenir plus intelligent et à arrêter de perdre votre argent, et DEUNA vous aide dans ce voyage.

Informations requises pour le rappel des charges

Les informations suivantes sont requises par événement de recharge pour être correctement transmises aux fournisseurs de services antifraude:

Options de recharge

DEUNA offers two options depending on the merchant's requirements, timing, and environment:

• Envoyez les recharges dans un fichier CSV à chargebacks@deuna.com

  • Seulement pour les transactions de production.

  • Le nom du fichier CSV doit être dans le format UUID-DDMMAA.csv

    • DEUNA merchant ID (UUID): 37e21ead-3951-4cbc-b075-9c635f4b8933
    • Date dans le DDMMAA: 051225
    • Exemple :37e21ead-3951-4cbc-b075-9c635f4b8933-051225.csv

  • Le format des données devrait être le suivant:

    transaction_id	external_id	chargeback_identifier	chargeback_status	chargeback_reason_code	chargeback_case_id	merchant_chargeback_id	chargeback_amount	détail	chargeback_date
    a596f725-e22b-411f-ac51-c94b2386b39b	merchant_test_5	chargeback_test_5	ouvert	0003	cbk_test_5	merchant_cbk_test_5	2000	En proceso judiciaire	2025-10-30T11:20:00Z
    d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9	merchant_test_6	chargeback_test_6	perdu	4837	cbk_test_6	merchant_cbk_test_6	550	Biens/services non reçus	2025-10-30T11:21:00Z

    
    
• Send chargebacks in JSON format through SFTP by following the guide below.
  • Pour les transactions Sandbox et Production.
  • Processing begins after the file is received. Confirm the expected schedule with your DEUNA Technical Account Manager.

Conditions requises

Pour compléter ce processus, vous avez besoin des renseignements suivants :

• Votre Merchant ID (fourni par DEUNA)
• Votre Clé privée SSH pour l'authentification (expliqué ci-dessous)
• Le Fichier JSON vous voulez télécharger

Télécharger un fichier SFTP#

Chargez les recharges vers nos serveurs SFTP.

1. Créer la clé SSH

Générez votre clé d'ordinateur

1. Ouvrir l'application Terminal (Windows 10, Windows 11)

2. Exécuter la commande ssh-keygen -t rsa -b 4096

3. Saisissez une clé de passe (suggéré 4 ou 6 chiffres pin numérique) quand vous demandez une phrase de passe et appuyez sur Entrée (enfin, il n'affiche pas les touches que vous appuyez)

4. Entrez à nouveau votre clé de passe et appuyez sur Entrée

5. Vous verrez la confirmation de la clé comme l'image suivante

Agrandir

6. Obtenez votre clé SSH en entrant cat ~/.ssh/id_rsa.pub , vous recevrez une réponse avec la clé comme l'exemple suivant:

Agrandir

2. Enregistrer la clé SSH pour DEUNA

Register your computer key with DEUNA.

1. Copier la clé SSH
2. Partagez-le avec votre DEUNA TPM: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC8YDqXwxnvJkXOK5Dne0Fzcmt/f5MlD5WpcICgJxVtOYYGP1M+zn+Z2e3EHcssxblOPykFmBax/WBtVbcgtxUxMypTUMqsKtUtbg9D9DSMIKPbk7+BpQpG1dAx/SPmK7v/Zq0tUdw5np8z3KFnyH7q1Bw4NFd9jk48/CqOftEJn28lprJRus8/K8Jy+3S2vyTl2g8YuVHYvznl59aVKKCtm//D79OjPKKsdN3upCN6mo8FTCf0Ku+KS/F6kCIXn/gwKtRNuMwffJq+g7/qaMmo3FGBiaw9DCTbL5D+INgvAlbfpruqOa7GsmPreq7371+Om5BsQz2I79WvJtbPwrv+YrbOm2FVaaeKg4LKs8uqlcgs/DXaRBNtdQLQVGND37dvxVNc6ZsFagdQF+OKRxPc5MsIwDZH1Fd6m9qAN/Vxgfl8a5gg57ovkd2yJC40Blmn1nRAFxTdVceV+9c0a6qG7RTMyli9se8PzSS4Ckk/IL5TBzzNyimDYYtQWZ7INPNiFxRUKBTAeqwI+5Xava2hWHA35WmPh+5kl/J9gS3noALSBe/DT4ie9IXP68r7Ril2vPkvY8ONIc2usTsyIRmVCIss3Ww7ekMYwfpx/D8lroWoqC8Go6eI5lMCKYXkkzz0nsWwASTVG8jhbDWs7sebxzX5EmWup3Rf/0fokJfN9w== admin@DESKTOP-T7IE9FG

Une fois enregistrée, la clé sera stockée dans votre ordinateur et aucune autre étape ne sera requise concernant la génération de clé et l'enregistrement.

3. Connectez-vous au serveur SFTP DEUNA

1. Ouvrir l'application Terminal

2. Environnement de la boîte à sable

   1. Saisissez la commande suivante sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io

3. Environnement de production

   1. Saisissez la commande suivante sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io

4. Vous recevrez la réponse suivante avec la question Are you sure you want to continue connecting (yes/no/[fingerprint])?:

Agrandir

5. Appuyez sur yes et entrez
6. Vous serez invité à: Enter passphrase for key 'C:\Users\Admin/.ssh/id_rsa’
7. Saisissez votre clé de passe et appuyez sur Entrée
8. Vous recevrez la confirmation Connected to [transfer-sftp.chargebacks.sandbox.deuna.io](http://transfer-sftp.chargebacks.sandbox.deuna.io/)

Agrandir

4. Créer un fichier JSON avec les entrées de rechargement

1. The JSON file must have the following structure (example for two entries):

   JSONCopier

   {
   "version" : "1.0",
   "records" : [
           {
               "transaction_id": "a596f725-e22b-411f-ac51-c94b2386b39b", 
               "external_id" : "merchant_test_5",
               "chargeback_identifier":"chargeback_test_5",
               "chargeback_status": "open" ,
               "chargeback_reason_code": "0003", 
               "chargeback_case_id": "cbk_test_5", 
               "merchant_chargeback_id": "merchant_cbk_test_5",
               "chargeback_amount": 2000, 
               "detail": "En proceso judicial",
               "chargeback_date": "2025-10-30T11:20:00Z"
           },
           {
               "transaction_id": "d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9", 
               "external_id" : "merchant_test_6",
               "chargeback_identifier":"chargeback_test_6",
               "chargeback_status": "lost",
               "chargeback_reason_code": "4837", 
               "chargeback_case_id": "cbk_test_6", 
               "merchant_chargeback_id": "merchant_cbk_test_6",
               "chargeback_amount": 550, 
               "detail": "Goods/Services not received",
               "chargeback_date": "2025-10-30T11:21:00Z"
           }
       ]
   }

2. Le corps est composé d'un champ nommé version avec la valeur constante 1.0, suivi d'un tableau nommé records.

3. Chaque objet à l'intérieur du tableau des enregistrements contient une entrée de chargeback, qui doit avoir la structure suivante :

4. Enregistrer le fichier avec un TIMESTAMP comme son nom YYYYMMDD HHMMSS.json. Exemple 20251104_193100.json
5. Store it in an easy-to-access folder, for example C:\Deuna_chargebacks\.

Agrandir

5. Tester la connexion SFTP

Envoyer le fichier en utilisant la connexion SFTP dans l'environnement Sandbox

1. Naviguez dans l'environnement Sandbox : cd /deuna-chargebacks-sbx

2. Saisissez la commande pour télécharger le fichier dans le répertoire du serveur SFTP pour l'environnement sélectionné: put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

3. Exemple : put C:\Deuna_chargebacks\20251104_193100.json inbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57

4. Vous recevrez un message avec les progrès et les résultats

Agrandir

5. Si vous recevez le message Couldn’t send packet: Broken pipe, vous devriez vous connecter à la SFTP avec la commande sftp -i ~/.ssh/id_rsa [developer@transfer-sftp.chargebacks.sandbox.deuna.io](mailto:developer@transfer-sftp.chargebacks.sandbox.deuna.io) et entrez votre clé de passe comme la phrase de passe pour la clé, puis essayez de télécharger le fichier en utilisant le point 1
6. Déconnecter avec la commande bye.

6. Voir le fichier des résultats de test

Si nécessaire, vous pouvez télécharger un fichier de résultats avec les étapes suivantes:

1. Connectez-vous de nouveau au serveur SFTP avec la commande sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io and enter your SSH key passphrase.
2. Naviguez dans l'environnement des bacs à sable : cd /deuna-chargebacks-sbx
3. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
4. Exemple cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
5. Entrez get YYYYMMDD_HHMMSS_output.json, où YYYYMMDD_HHMMSS est l'horodatage du fichier de rechargement téléchargé précédemment.
6. Le fichier sera téléchargé dans le dossier où le fichier de recharge est situé
7. Exemple get 20251104_193100_output.json
8. Complémentaire, vous pouvez ajouter un emplacement spécifique pour télécharger le fichier aussi bien: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

7. Envoyer le fichier à Production

Envoyer le fichier en utilisant la connexion SFTP dans l'environnement Production

1. Saisissez la commande pour télécharger le fichier dans le répertoire du serveur SFTP pour l'environnement sélectionné put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

2. Exemple : put C:\Deuna_chargebacks\20251104_193100.json inbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57

3. Vous recevrez un message avec les progrès et les résultats

Agrandir

1. If you receive Couldn’t send packet: Broken pipe, reconnect with sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io, enter your SSH key passphrase, and retry the upload from step 1.

2. Déconnecter avec la commande bye

8. Voir le fichier des résultats de production

Si nécessaire, vous pouvez télécharger un fichier de résultats:

1. Connectez-vous de nouveau au serveur SFTP avec la commande sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io and enter your SSH key passphrase.
2. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
3. Exemple cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
4. Entrez get YYYYMMDD_HHMMSS_output.json, où YYYYMMDD_HHMMSS est l'horodatage du fichier de rechargement téléchargé précédemment.
5. Le fichier sera téléchargé dans le dossier où le fichier de recharge est situé
6. Exemple get 20251104_193100_output.json
7. Complémentaire, vous pouvez ajouter un emplacement spécifique pour télécharger le fichier aussi bien: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

Dépannage#

Learn how to troubleshoot common issues.

Connexion refusée

Si vous avez des problèmes de connexion, faites comme suit:

• Vérifiez que votre clé privée a les permissions correctes : chmod 600 /path/to/private_key
• Assurez-vous d'utiliser le bon fichier de clé privée
• Confirmez que votre adresse IP est sur liste blanche (assistance de contact si nécessaire)

Autorisation refusée

If you have permission problems, check the following:

• Verify you're using the correct Merchant ID
• Assurez-vous que votre compte a les permissions de télécharger pour ce répertoire
• Contacter le support si le problème persiste

Le fichier existe déjà

Si vous obtenez des erreurs de fichier, faites comme suit

• Utilisez un horodatage unique pour chaque téléchargement
• Vérifiez le répertoire avec ls avant le téléchargement

Fichier résultat non trouvé

Si vous avez des problèmes avec la recherche de fichiers, faites comme suit:

• Accorder suffisamment de temps pour le traitement (temps de traitement typique : [précisez votre ALS])
• Verify you're checking the correct outbound directory for your Merchant ID
• Assurez-vous que le nom du fichier d'entrée correspond exactement (timestamps doivent correspondre)
• Contactez le support si le fichier n'apparaît pas dans le délai prévu

Impossible de télécharger le fichier résultat

Si vous avez des problèmes avec les téléchargements de fichiers, faites comme suit

• Vérifiez que vous avez lu les permissions sur le répertoire sortant
• Vérifiez que vous utilisez le nom exact du fichier, y compris le _output.json suffixe
• Assurer un espace disque local suffisant pour le téléchargement

Assistance

Si vous rencontrez des problèmes ou avez des questions :

• Courriel : support@deuna.io
• Inclure votre ID de marchand et une description du problème

Meilleures pratiques en matière de sécurité

Gardez à l'esprit les pratiques de sécurité suivantes :

• Gardez votre clé privée sécurisée et ne la partagez jamais
• Utilisez les permissions de fichier forte sur votre clé privée (chmod 600)
• Télécharger uniquement les fichiers pendant vos fenêtres de traitement programmées
• Vérifier le contenu du fichier avant de télécharger vers la production