Téléchargement de commentaires sur les litiges

Envoyer les résultats historiques de litiges via DEUNA afin que le fournisseur de lutte contre la fraude configuré puisse tirer parti des résultats confirmés. Ceci est un modèle de feedback.; cela ne crée pas de litige auprès du processeur, ne soumet pas de preuves ni ne gère pas un litige en cours. Utilisez Gestion des litiges pour les litiges actifs.

Cycle de rétroactionInterroger Athia à ce sujet#

Avant de commencerInterroger Athia à ce sujet#

Confirmez avec votre TAM les éléments suivants :

• la connexion anti-fraude qui consommera la rétroaction ;
• si l'e-mail, SFTP ou les deux sont activés ;
• les environnements et les types de transactions acceptés par chaque canal ;
• le nom d'hôte SFTP, le port, le nom d'utilisateur, l'empreinte de clé du serveur et les répertoires du commerçant ;
• si un fichier de résultat est généré et le temps de traitement normal pour votre compte ;
• les exigences d'encodage, de conservation et d'escalade approuvées.

Vous devez également disposer de l'identifiant de transaction DEUNA pour chaque enregistrement. Ne remplacez pas par un token de commande, un identifiant de transaction du processeur ou un identifiant de remboursement du commerçant.

Schéma d'enregistrementInterroger Athia à ce sujet#

Option A : livraison par e-mail approuvéeInterroger Athia à ce sujet#

Utilisez cette option uniquement lorsque DEUNA a approuvé un flux de travail d'e-mail pour l'environnement cible.

1. Exportez un fichier CSV avec les noms de champs de la table de schéma.
2. Nommez-le avec votre identifiant de commerçant attribué et la convention de date d'accordée. Utilisez des marqueurs lors de la création d'automatisation, par exemple YOUR_MERCHANT_ID-DDMMYY.csv.
3. Validez toutes les valeurs requises et assurez-vous que le CSV est encodé de manière cohérente.
4. Envoyez-le uniquement au destinataire confirmé pour votre compte via une boîte de réception professionnelle approuvée.
5. Conservez les preuves de livraison et de réconciliation requises par votre politique.

transaction_id,external_id,chargeback_identifier,chargeback_status,chargeback_reason_code,chargeback_case_id,merchant_chargeback_id,chargeback_amount,detail,chargeback_date
DEUNA_TRANSACTION_ID,MERCHANT_RECORD_ID,ACQUIRER_REFERENCE,open,REASON_CODE,PROVIDER_CASE_ID,MERCHANT_CASE_ID,2000,Confirmed fraud outcome,2026-10-30T11:20:00Z

DEUNA_TRANSACTION_ID est un marqueur explicite. Remplacez-le par un identifiant de transaction réel provenant de votre processus d'exportation protégé ; ne copiez pas d'identifiants d'exemple dans la production.

Option B : livraison SFTPInterroger Athia à ce sujet#

Utilisez SFTP uniquement après que DEUNA ait créé le compte et fourni les valeurs de connexion appropriées via un canal approuvé.

1. Créer une clé SSH dédiée

Générer une paire de clés moderne sur la machine ou l'environnement de confiance qui effectue le téléchargement :

ssh-keygen -t ed25519 -a 100 -f ./deuna_chargeback_upload

Protéger la clé privée à l'aide des contrôles requis pour cet environnement. Partager seulement deuna_chargeback_upload.pub via le canal d'onboarding approuvé. Ne collez jamais la clé privée dans un ticket, un chat, une documentation, un référentiel ou une application client.

2. Vérifier le serveur provisionné

Avant la première connexion, comparez l'empreinte du serveur avec la valeur fournie par DEUNA. Ne validez pas une clé inattendue pour continuer.

sftp -i ./deuna_chargeback_upload YOUR_SFTP_USER@YOUR_SFTP_HOST

YOUR_SFTP_USER et YOUR_SFTP_HOST Ces champs sont des placeholders. Utilisez les valeurs fournies pour l'environnement prévu : sandbox et production peuvent avoir des comptes et des clés d'hôte différents.

3. Créer le fichier JSON par lot

Le corps JSON contient la version du schéma et un records tableau :

{
  "version": "1.0",
  "records": [
    {
      "transaction_id": "DEUNA_TRANSACTION_ID",
      "external_id": "MERCHANT_RECORD_ID",
      "chargeback_identifier": "ACQUIRER_REFERENCE",
      "chargeback_status": "open",
      "chargeback_reason_code": "REASON_CODE",
      "chargeback_case_id": "PROVIDER_CASE_ID",
      "merchant_chargeback_id": "MERCHANT_CASE_ID",
      "chargeback_amount": 2000,
      "detail": "Confirmed fraud outcome",
      "chargeback_date": "2026-10-30T11:20:00Z"
    }
  ]
}

Utilisez un nom de fichier unique YYYYMMDD_HHMMSS.json sauf si votre contrat provisionné spécifie une convention différente. Générez le nom de fichier en UTC pour une corrélation de lot non ambiguë.

4. Télécharger dans le répertoire d'entrée désigné

Après la connexion, accédez au répertoire exact fourni pour l'environnement et téléchargez le fichier :

sftp> cd YOUR_ASSIGNED_INBOUND_DIRECTORY
sftp> put 20261030_112000.json
sftp> ls
sftp> bye

Ne créez pas de répertoire à partir d'un identifiant de commerçant, sauf si les instructions fournies l'exigent explicitement. Une confirmation de transfert réussie ne signifie pas l'acceptation d'un enregistrement. put Une confirmation de transfert réussie, et non l'acceptation d'un enregistrement.

5. Vérifier les résultats

Si votre compte génère des fichiers de résultats, récupérez le fichier du répertoire de sortie désigné et comparez-le au lot d'entrée. Le nom de fichier et le schéma de réponse peuvent varier en fonction du contrat fourni ; utilisez les valeurs fournies lors de l'inscription.

sftp> cd YOUR_ASSIGNED_OUTBOUND_DIRECTORY
sftp> ls
sftp> get YOUR_RESULT_FILE.json
sftp> bye

Classifiez chaque enregistrement comme accepté, rejeté ou toujours non résolu. Corrigez les enregistrements rejetés avant la ré-soumission et évitez de réexécuter les résultats acceptés, sauf si le support DEUNA vous le demande.

Validation et idempotenceInterroger Athia à ce sujet#

Validez un lot avant le transfert :

• version est la valeur 1.0 autorisée pour les téléchargements JSON ;
• records est un tableau non vide.
• chaque transaction_id appartient au commerçant et à l'environnement prévus.
• chaque chargeback_date est une valeur de date et d'heure valide conforme à la norme ISO 8601, incluant une indication de fuseau horaire.
• Chaque montant est un entier en unités mineures et utilise la devise de paiement originale.
• Valeurs et longueurs maximales conformes au schéma.
• Le nom de fichier est unique et ne remplace pas une ancienne transaction.
• Le fichier ne contient aucune colonne ou attribut en dehors de ce qui est spécifié dans le contrat.

Conserver un enregistrement de lot côté marchand contenant le checksum du fichier, l'heure de création, l'environnement, le temps de transfert et le résultat par enregistrement. Cette preuve vous permet de réessayer les données rejetées sans renvoyer inutilement l'ensemble du lot.

DépannageInterroger Athia à ce sujet#

Lors de l'escalade, inclure l'ID du commerçant, l'environnement, le nom de fichier, la somme de contrôle, l'horodatage du transfert et le texte d'erreur nettoyé. Ne jamais joindre une clé privée, un secret de fournisseur, des données de carte brutes ou une exportation client non masquée.

Liste de contrôle pour aller en ligneInterroger Athia à ce sujet#

1. DEUNA confirme le fournisseur cible, l'environnement, le canal de transfert et les autorisations de compte.
2. La sécurité vérifie la garde des clés, la validation de l'hôte, la liste d'autorisation, le chiffrement, l'accès et la conservation.
3. Un lot de test prouve la gestion des enregistrements acceptés et rejetés.
4. Les opérations peuvent corréler chaque enregistrement d'entrée avec son résultat de traitement.
5. La surveillance alerte sur les transferts manquants, les enregistrements rejetés et les lots non résolus.
6. Le guide d'opération de production nomme le propriétaire et le canal d'escalade approuvé.