Caricamento di Chargebacks

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.

Come funziona il chargebacks#

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.

Migliorare i risultati antifrode

Scopri come i chargeback migliorano la tua strategia anti-fraud.

Corregge "False Negatives"

Il lavoro principale del modello è quello di segnare le transazioni.

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.

Poteri riconoscimento del modello

Il modello anti-fraud analizza migliaia di punti di dati.

Quando riceve un chargeback, rivaluta tutti i dati associati a tale transazione fallita:

1. Quale indirizzo email è stato utilizzato?
2. Quale impronta del dispositivo?
3. Qual era l'indirizzo di spedizione?
4. Qual era il periodo della giornata?

Il modello può ora trovare nuovi modelli nascosti. Ad esempio, potrebbe imparare che le transazioni da una specifica gamma IP utilizzando una nuova e-mail e l'acquisto di beni digitali sono improvvisamente molto più rischioso di quanto pensasse originariamente.

Consente l'analisi dei collegamenti

Le frodi spesso riutilizzano e-mail, dispositivi o indirizzi di spedizione.

Quando si carica un chargeback, il provider collega che la frode a ogni punto di dati della transazione.

1. Prima: Il dispositivo del truffatore (Device_XYZ) è stato visto come sicuro.
2. Dopo: Caricate un chargeback per quella transazione. Device_XYZ è ora contrassegnato come ad alto rischio.
3. Risultato: La prossima volta che qualsiasi transazione viene da 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.

Mantiene il modello in alto a dita

Le tattiche delle frodi cambiano costantemente. I modelli che hanno lavorato per i truffatori il mese scorso saranno diversi il mese prossimo.

Caricare i chargeback più vicini al tempo reale è l'unico modo per garantire che il modello di apprendimento automatico si adatta a queste nuove tattiche quanto appaiono.

In breve, caricare i chargeback non è solo un compito amministrativo; è il nucleo del processo di machine learning.

È come si insegna attivamente il sistema per ottenere più intelligente e smettere di perdere i vostri soldi, e DEUNA vi aiuta in questo viaggio.

Informazioni sul chargeback richieste

Per ogni evento di chargeback è necessario fornire informazioni adeguate ai fornitori antifrode:

Opzioni di rimborso

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

• Inviare i chargeback in un file CSV a chargebacks@deuna.com

  • Solo per le transazioni di produzione.

  • Il nome del file CSV deve essere nel formato UUID-DDMMAA.csv

    • DEUNA merchant ID (UUID): 37e21ead-3951-4cbc-b075-9c635f4b8933
    • Data in DDMMAA: 051225
    • Esempio:37e21ead-3951-4cbc-b075-9c635f4b8933-051225.csv

  • Il formato dei dati dovrebbe essere il seguente

    transaction_id	external_id	chargeback_identifier	chargeback_status	chargeback_reason_code	chargeback_case_id	merchant_chargeback_id	chargeback_amount	dettaglio	chargeback_date
    a596f725-e22b-411f-ac51-c94b2386b39b	merchant_test_5	chargeback_test_5	aperto	0003	cbk_test_5	merchant_cbk_test_5	2000	En proceso giudiziale	2025-10-30T11:20:00Z
    d3daecd7-6f3a-4cb4-98a8-c077cfd5b9d9	merchant_test_6	chargeback_test_6	Perduta	4837	cbk_test_6	merchant_cbk_test_6	550	Prodotti/Servizi non ricevuti	2025-10-30T11:21:00Z

    
    
• Send chargebacks in JSON format through SFTP by following the guide below.
  • Per le operazioni di Sandbox e Production.
  • Processing begins after the file is received. Confirm the expected schedule with your DEUNA Technical Account Manager.

Requisiti

Per completare questo processo, è necessario avere le seguenti informazioni:

• Il tuo Merchant ID (fornito da DEUNA)
• Il tuo Chiave privata SSH per l'autenticazione (spiegato di seguito)
• Il File JSON vuoi caricare

Caricare un file SFTP#

Caricare i backup dei nostri server SFTP.

1. Creare la chiave SSH

Generare il computer Key

1. App Open Terminal (Windows 10, Windows 11)

2. Eseguire il comando ssh-keygen -t rsa -b 4096

3. Inserisci un passkey (suggested 4 o 6 cifre pin numerico) quando richiesto per passphrase e premere Invio (Hint: non mostra le chiavi che si sta premendo)

4. Inserisci nuovamente il tuo passkey e premi Invio

5. Vedrete la conferma chiave come la seguente immagine

Ingrandisci

6. Ottenere la chiave SSH entrando cat ~/.ssh/id_rsa.pub , riceverete una risposta con la chiave come il seguente esempio:

Ingrandisci

2. Registrare la chiave SSH per DEUNA

Register your computer key with DEUNA.

1. Copiare la chiave SSH
2. Condividi con il tuo TPM DEUNA: 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

Una volta registrato, la chiave verrà memorizzata nel computer e non saranno necessari ulteriori passaggi per quanto riguarda la generazione e la registrazione di chiavi.

3. Collegare al server DEUNA SFTP

1. Aprire l'App Terminal

2. Sandbox ambiente

   1. Inserisci il comando seguente sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io

3. Ambiente di produzione

   1. Inserisci il comando seguente sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.prod.deuna.io

4. Riceverai la seguente risposta con la domanda Are you sure you want to continue connecting (yes/no/[fingerprint])?:

Ingrandisci

5. Pressa stampa yes e entrare
6. Ti verrà chiesto di: Enter passphrase for key 'C:\Users\Admin/.ssh/id_rsa’
7. Inserisci il tuo passkey e premi entrare
8. Riceverai la conferma Connected to [transfer-sftp.chargebacks.sandbox.deuna.io](http://transfer-sftp.chargebacks.sandbox.deuna.io/)

Ingrandisci

4. Creare un file JSON con le voci di chargeback

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

   JSONCopia

   {
   "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. Il corpo è composto da un campo chiamato version con il valore costante 1.0, seguito da un array di nome records.

3. Ogni oggetto all'interno della matrice di dischi contiene una voce di chargeback, che deve avere la seguente struttura:

4. Salvare il file con un TIMESTAMP come il suo nome YYYYYYMMDD HHMMSS.json. Esempio 20251104_193100.json
5. Store it in an easy-to-access folder, for example C:\Deuna_chargebacks\.

Ingrandisci

5. Testare la connessione SFTP

Inviare il file utilizzando la connessione SFTP nell'ambiente Sandbox

1. Navigare in ambiente Sandbox: cd /deuna-chargebacks-sbx

2. Inserisci il comando per caricare il file nella directory server SFTP per l'ambiente selezionato: put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

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

4. Riceverai un messaggio con i progressi e i risultati

Ingrandisci

5. Nel caso in cui si ricevesse il messaggio Couldn’t send packet: Broken pipe, si dovrebbe riconnettersi al SFTP con il comando sftp -i ~/.ssh/id_rsa [developer@transfer-sftp.chargebacks.sandbox.deuna.io](mailto:developer@transfer-sftp.chargebacks.sandbox.deuna.io) e inserire il passkey come passphrase per la chiave, e poi riprovare per caricare il file utilizzando a partire dal punto 1
6. Disconnettersi con il comando bye.

6. Vedi il file dei risultati del test

Se necessario, è possibile scaricare un file di risultati con i seguenti passaggi:

1. Collegare nuovamente al server SFTP con il comando sftp -i ~/.ssh/id_rsa developer@transfer-sftp.chargebacks.sandbox.deuna.io and enter your SSH key passphrase.
2. Navigare nell'ambiente sandbox: cd /deuna-chargebacks-sbx
3. Navigate to the outbound merchant folder with cd /outbound/merchants/{{merchant_id}}.
4. Esempio cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
5. Inserisci get YYYYMMDD_HHMMSS_output.jsondove? YYYYMMDD_HHMMSS è il timestamp del file di chargeback caricato in precedenza.
6. Il file verrà scaricato nella cartella in cui si trova il file di chargeback
7. Esempio get 20251104_193100_output.json
8. Complementare, è possibile aggiungere una posizione specifica per scaricare il file pure: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

7. Inviare il file alla produzione

Inviare il file utilizzando la connessione SFTP in ambiente di produzione

1. Inserisci il comando per caricare il file nella directory server SFTP per l'ambiente selezionato put {{route/to/file/in/pc-local}}/{{chargeback file name}} inbound/merchants/{{merchant_id}}

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

3. Riceverai un messaggio con i progressi e i risultati

Ingrandisci

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. Disconnettersi con il comando bye

8. Vedi il file dei risultati di produzione

Se necessario, è possibile scaricare un file di risultati:

1. Collegare nuovamente al server SFTP con il comando 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. Esempio cd /outbound/merchants/38696c00-9b00-4be9-84bc-60e7d7a7ba57
4. Inserisci get YYYYMMDD_HHMMSS_output.jsondove? YYYYMMDD_HHMMSS è il timestamp del file di chargeback caricato in precedenza.
5. Il file verrà scaricato nella cartella in cui si trova il file di chargeback
6. Esempio get 20251104_193100_output.json
7. Complementare, è possibile aggiungere una posizione specifica per scaricare il file pure: get YYYYMMDD_HHMMSS_output.json /path/to/local/destination/

Risoluzione dei problemi#

Learn how to troubleshoot common issues.

Connessione rifiutata

Se hai problemi con le connessioni, fai come segue:

• Verificare che la chiave privata abbia le autorizzazioni corrette: chmod 600 /path/to/private_key
• Assicurarsi di utilizzare il file chiave privata corretto
• Confermare che l'indirizzo IP è whitelist (consultare se necessario)

Permesso negato

If you have permission problems, check the following:

• Verify you're using the correct Merchant ID
• Assicurarsi che il tuo account abbia autorizzazioni di upload per questa directory
• Contatto di supporto se il problema persiste

File già esiste

Se si ottengono errori di file, fare come segue

• Utilizzare un timestamp unico per ogni upload
• Controlla la directory con ls prima di caricare

Risultato file non trovato

Se hai problemi con il file di ricerca, eseguire come segue

• Permettere tempo sufficiente per l'elaborazione (tempo di elaborazione tipica: [specificare il SLA]))
• Verify you're checking the correct outbound directory for your Merchant ID
• Assicurarsi che il nome del file di input corrisponda esattamente (i timestamp devono corrispondere)
• Supporto di contatto se il file non appare entro il termine di tempo previsto

Non è possibile scaricare il file di risultato

Se hai problemi con i download dei file, fai come segue

• Verificare che si siano letti i permessi sulla directory in uscita
• Controlla che stai usando il nome del file esatto, incluso il _output.json Suffisso
• Assicurare spazio su disco locale sufficiente per il download

Supporto

Se si incontrano problemi o hanno domande:

• Email: support@deuna.io
• Includere il vostro ID Merchant e una descrizione del problema

Migliori pratiche di sicurezza

Tenete a mente le seguenti pratiche di sicurezza:

• Tieni la chiave privata sicura e non condividerla mai
• Utilizzare autorizzazioni di file forti sulla chiave privata (chmod 600)
• Caricare solo i file durante le finestre di elaborazione programmate
• Verificare i contenuti dei file prima di caricare sulla produzione