Invio di feedback sui contesti di addebito

Inviare i risultati storici dei contesti di addebito tramite DEUNA, in modo che il fornitore anti-frode configurato possa apprendere dai risultati confermati. Questo è un modello di feedback; non crea una contestazione da parte del terminale, non richiede la presentazione di prove né gestisce un caso di contestazione attivo. Utilizzare Gestione delle controversie Per le controversie attive.

Ciclo di gestione del feedbackChiedi ad Athia informazioni#

Prima di iniziareChiedi ad Athia informazioni#

Conferma con il tuo referente TAM quanto segue:

• la connessione anti-frode che consumerà il feedback;
• se è abilitata l'email, SFTP o entrambe;
• gli ambienti e i tipi di transazione accettati da ciascun canale;
• il nome host SFTP, la porta, il nome utente, l'impronta del server host e le directory del commerciante;
• se viene generato un file di risultato e quanto tempo normalmente impiega l'elaborazione per il tuo account;
• i requisiti di crittografia, conservazione e escalation approvati.

È necessario anche l'ID di transazione di DEUNA per ogni record. Non utilizzare un token d'ordine, l'ID di transazione del processore o l'ID di contestazione del commerciante.

Schema del recordChiedi ad Athia informazioni#

Opzione A: Convalida tramite emailChiedi ad Athia informazioni#

Utilizzare questa opzione solo quando DEUNA ha approvato un flusso di lavoro via email per l'ambiente di destinazione.

1. Esporta un file CSV con i nomi dei campi definiti nello schema.
2. Assegnare un nome utilizzando il tuo identificatore di commerciante e la convenzione di data concordata. Utilizzare segnaposto durante l'automazione, ad esempio YOUR_MERCHANT_ID-DDMMYY.csv.
3. Verificare che tutti i valori obbligatori siano presenti e che il file CSV sia codificato in modo coerente.
4. Invia la notifica esclusivamente al destinatario confermato per il tuo account tramite una casella di posta elettronica aziendale approvata.
5. Conserva le prove di consegna e riconciliazione richieste dalla tua politica.

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 è un segnaposto esplicito. Sostituiscilo con un ID di transazione reale proveniente dal tuo processo di esportazione protetto; non copiare esempi di identificatori in ambiente di produzione.

Opzione B: Consegna tramite SFTP preconfigurataChiedi ad Athia informazioni#

Utilizzare SFTP solo dopo che DEUNA ha creato l'account e fornito i valori di connessione appropriati tramite un canale approvato.

1. Creare una chiave SSH dedicata

Generare una coppia di chiavi moderna sulla macchina o sull'ambiente di lavoro che esegue l'upload:

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

Proteggere la chiave privata utilizzando i controlli richiesti per quell'ambiente. Condividere solo solo deuna_chargeback_upload.pub tramite il canale di onboarding approvato. Non incollare mai la chiave privata in un ticket, chat, documentazione, repository o applicazione client.

2. Verificare il server fornito

Prima della prima connessione, confrontare l'impronta digitale del server con il valore fornito da DEUNA. Non accettare una chiave inattesa per continuare.

sftp -i ./deuna_chargeback_upload YOUR_SFTP_USER@YOUR_SFTP_HOST

YOUR_SFTP_USER e YOUR_SFTP_HOST Questi sono dei segnaposto. Utilizzare i valori forniti per l'ambiente previsto; sandbox e produzione possono avere account e chiavi host diversi.

3. Creare il batch JSON

Il corpo JSON contiene la versione dello schema e un records array:

{
  "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"
    }
  ]
}

Utilizzare un nome di file univoco YYYYMMDD_HHMMSS.json a meno che il contratto fornito non specifichi una convenzione diversa. Generare il nome del file in UTC per garantire la correlazione del batch.

4. Caricare nella directory di inbound assegnata

Dopo la connessione, passare alla directory esatta fornita per l'ambiente e caricare il file:

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

Non creare una directory basata sull'ID del commerciante a meno che le istruzioni fornite non lo richiedano esplicitamente. Un risultato di trasferimento put di conferma, non accettazione del record.

5. Verificare i risultati

Se il tuo account genera file di risultato, recupera il file dalla directory di destinazione assegnata e confrontalo con il batch di input. Il nome del file e lo schema di risposta possono variare in base al contratto fornito; utilizza i valori forniti durante l'onboarding.

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

Classifica ogni record come accettato, rifiutato o ancora non risolto. Correggi i record rifiutati prima della risubmissione ed evita di ripetere i risultati accettati, a meno che il supporto di DEUNA non ti indichi di farlo.

Validazione e idempotenzaChiedi ad Athia informazioni#

Verificare un batch prima della trasmissione:

• version il valore supportato 1.0 per caricamenti JSON;
• records è un array non vuoto;
• ogni transaction_id appartiene al commerciante e all'ambiente previsti.
• ogni chargeback_date è un timestamp valido secondo lo standard ISO 8601, con indicazione del fuso orario;
• Ogni importo è un numero intero in unità minori e utilizza la valuta originale di pagamento.
• I valori dell'enumerazione e le lunghezze massime corrispondono allo schema;
• Il nome del file è univoco e non sovrascrive un batch precedente.
• Il file non contiene colonne o attributi diversi da quelli approvati nel contratto.

Mantenere un registro lato merchant contenente il checksum del file, l'ora di creazione, l'ambiente, il tempo di trasferimento e il risultato per ogni record. Questa evidenza consente di riprovare i dati rifiutati senza dover ri-inviare l'intero batch.

Risoluzione dei problemiChiedi ad Athia informazioni#

Quando si verifica l'escalation, includere l'ID del commerciante, l'ambiente, il nome del file, il checksum, il timestamp del trasferimento e il testo di errore sanificato. Non allegare una chiave privata, un segreto del fornitore, dati di carta grezzi o un'esportazione cliente non anonimizzata.

Elenco di controllo Go-liveChiedi ad Athia informazioni#

1. DEUNA conferma il provider di destinazione, l'ambiente, il canale di trasferimento e le autorizzazioni dell'account.
2. La sicurezza verifica la custodia delle chiavi, la validazione dell'host-key, l'allowlisting, la crittografia, l'accesso e la conservazione.
3. Un batch di test dimostra la gestione corretta dei record accettati e rifiutati.
4. Le operazioni possono correlare ogni record di input con il risultato del suo processo.
5. Il monitoraggio genera avvisi per trasferimenti mancanti, record rifiutati e batch non risolti.
6. Il manuale operativo per l'esecuzione di produzione specifica il proprietario e il canale di escalation approvato.