Annotare le valutazioni con gli eventi di transazione

Le annotazioni degli eventi di transazione in Fraud Defense ti consentono di fornire dati sul ciclo di vita dei pagamenti post-valutazione, come liquidazioni, storni di addebito e rimborsi. Questo feedback ti aiuta a perfezionare il modello specifico del sito e migliora i futuri esiti relativi alle attività fraudolente.

Per ottenere le migliori prestazioni, Transaction defense deve poter analizzare gli eventi del ciclo di vita dei pagamenti per le transazioni. Pertanto, ti consigliamo di inviare annotazioni per le valutazioni che hai creato con i dati delle transazioni. Ad esempio, puoi fornire le informazioni sulla transazione a Transaction defense come evento di transazione nei seguenti scenari:

  • Il fornitore di servizi di pagamento accetta o rifiuta la transazione.

  • Il commerciante emette un rimborso.

  • L'emittente del pagamento presenta una richiesta di rimborso.

Per scoprire di più su come inviare annotazioni, consulta l'articolo Annota le valutazioni.

Ti consigliamo di effettuare queste richieste automaticamente nell'ambito della logica corrispondente nel tuo sistema quando i dati sono disponibili, ad esempio quando lo stato di una transazione cambia.

Dopo aver creato una valutazione con i dati delle transazioni inclusi, Transaction defense restituisce un verdetto e un nome della valutazione. Annota la valutazione con gli eventi di transazione nelle seguenti fasi importanti del ciclo di vita del pagamento quando si verificano:

Tipo di evento Descrizione Esempio di motivo Esempio di valore
MERCHANT_APPROVE | MERCHANT_DENY Quando decidi se consentire che la transazione prosegua. IN_HOUSE N/D
AUTHORIZATION | AUTHORIZATION_DECLINE Quando invii la transazione da elaborare e l'emittente della carta decide se consentire che la transazione prosegua. 82 (un codice motivo che indica che il CVV non era corretto) N/D
CHARGEBACK Quando l'addebito della transazione viene effettuato. Card Reported Stolen 20 (rappresenta uno storno di addebito parziale di 20 unità di valuta)

Insieme al tipo di evento CHARGEBACK, includi il codice motivo dello storno di addebito fornito dall'emittente della carta utilizzando il campo reason. Inoltre, includi l'importo monetario dello storno di addebito nel campo value se lo storno di addebito della transazione è stato parziale.

Nel campo dell'evento di transazione reason, includi termini chiarificatori per fornire un contesto più ampio sul motivo dell'evento o fornisci i codici motivo ottenuti direttamente dal circuito di pagamento o dall'emittente della carta. Questi termini e codici variano a seconda del tipo di evento.

La tabella seguente riporta l'elenco completo dei tipi di eventi di transazione:

Motivo dell'annotazione Descrizione
MERCHANT_APPROVE Indica che la transazione è stata approvata dal commerciante. I motivi associati possono includere termini come IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MERCHANT_DENY Indica che la transazione è stata rifiutata e conclusa a causa di rischi rilevati dal commerciante. I motivi associati possono includere termini come IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MANUAL_REVIEW Indica che la transazione è in fase di valutazione da parte di un revisore umano, a causa di sospetti o rischi.
AUTHORIZATION Indica che il tentativo di autorizzazione con l'emittente della carta è andato a buon fine.
AUTHORIZATION_DECLINE Indica che il tentativo di autorizzazione con l'emittente della carta non è andato a buon fine. I motivi associati possono includere il codice 54 di Visa, che indica che la carta è scaduta, o il codice 82, che indica che il CVV non è corretto.
PAYMENT_CAPTURE Indica che la transazione è stata completata perché i fondi sono stati liquidati.
PAYMENT_CAPTURE_DECLINE Indica che non è stato possibile completare la transazione perché i fondi non sono stati liquidati.
CANCEL Indica che la transazione è stata annullata. Specifica il motivo dell'annullamento. Ad esempio, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Indica che il commerciante ha ricevuto una richiesta di storno di addebito per frode per la transazione, con richiesta di ulteriori informazioni prima che venga emesso ufficialmente uno storno di addebito per frode e venga inviata una notifica di storno di addebito formale.
CHARGEBACK_ALERT Indica che il commerciante ha ricevuto un avviso di storno di addebito a causa di attività fraudolente per la transazione. Viene avviata la procedura di risoluzione della contestazione senza coinvolgere il circuito di pagamento.
FRAUD_NOTIFICATION Indica che è stata emessa una notifica di attività fraudolenta per la transazione, inviata dalla banca emittente dello strumento di pagamento perché la transazione sembra essere fraudolenta. Ti consigliamo di includere i dati TC40 o SAFE nel campo reason per questo tipo di evento. Per gli storni di addebito parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK Indica che il commerciante è stato informato dal circuito di pagamento che la transazione è entrata nella procedura di storno di addebito a causa di attività fraudolente. Esempi di codici motivo includono 6005 e 6041 di Discover. Per gli storni di addebito parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK_REPRESENTMENT Indica che la transazione è entrata nella procedura di storno di addebito a causa di una frode e che il commerciante ha scelto di presentare una contestazione. Alcuni esempi di motivi sono 6005 e 6041 di Discover. Per gli storni di addebito parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK_REVERSE Indica che la transazione ha ricevuto uno storno di addebito per attività fraudolenta che era illegittimo e che è stato quindi annullato. Per gli storni di addebito parziali, ti consigliamo di includere un importo nel campo value.
REFUND_REQUEST Indica che il commerciante ha ricevuto un rimborso per una transazione completata. Per i rimborsi parziali, ti consigliamo di includere un importo nel campo value. Esempio di motivo: FRAUD.
REFUND_DECLINE Indica che il commerciante ha ricevuto una richiesta di rimborso per questa transazione, ma l'ha rifiutata. Per i rimborsi parziali, ti consigliamo di includere un importo nel campo value. Esempio di motivo: FRAUD.
REFUND Indica che la transazione completata è stata rimborsata dal commerciante. Per i rimborsi parziali, ti consigliamo di includere un importo nel campo value. Esempio di motivo: PROACTIVE_FRAUD.
REFUND_REVERSE Indica che la transazione completata è stata rimborsata dal commerciante e che questo rimborso è stato stornato. Per i rimborsi parziali, ti consigliamo di includere un importo nel campo value.

L'esempio seguente mostra un payload di annotazione di esempio contenente un evento di transazione. Per maggiori dettagli, consulta Annota le valutazioni.

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

Passaggi successivi