Annotare le valutazioni con gli eventi di transazione

Questa pagina descrive come annotare le valutazioni con eventi di transazione per perfezionare il modello specifico per il sito.

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 i test che hai creato con i dati sulle 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 Annotare i test.

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

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 (che rappresenta uno storno parziale di 20 unità di valuta)

Oltre al tipo di evento CHARGEBACK, includi il codice motivo del chargeback fornito dall'emittente della carta utilizzando il campo reason. Includi anche l'importo monetario riaccreditato nel campo value se la transazione è stata riaccreditata parzialmente.

Nel campo reason dell'evento di transazione, includi termini chiarificatori per fornire maggiori informazioni sul motivo dell'evento oppure fornisci codici motivo che vengono 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 specifica l'elenco completo dei tipi di eventi di transazione:

Motivo dell'annotazione Descrizione
MERCHANT_APPROVE Indica che la transazione è approvata dal commerciante. I motivi di accompagnamento 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 di accompagnamento possono includere termini come IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MANUAL_REVIEW Indica che la transazione è in fase di valutazione da parte di una persona fisica 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 è riuscito. I motivi che accompagnano l'errore possono includere il codice 54 di Visa, che indica che la carta è scaduta, o il codice 82, che indica che il CVV è errato.
PAYMENT_CAPTURE Indica che la transazione è stata completata perché i fondi sono stati regolati.
PAYMENT_CAPTURE_DECLINE Indica che la transazione non è stato possibile completarla perché i fondi non sono stati regolati.
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, che richiede informazioni aggiuntive prima che venga emesso ufficialmente uno storno di addebito per frode e venga inviata una notifica formale di storno di addebito.
CHARGEBACK_ALERT Indica che il commerciante ha ricevuto un avviso di storno di addebito per frode per la transazione. Viene avviata la procedura di risoluzione della contestazione senza coinvolgere il circuito di pagamento.
FRAUD_NOTIFICATION Indica che per la transazione è stata emessa una notifica di frode, inviata dalla banca emittente dello strumento di pagamento perché la transazione sembra essere fraudolenta. Per questo tipo di evento, ti consigliamo di includere i dati TC40 o SAFE nel campo reason. Per gli storni parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK Indica che la rete di pagamento ha comunicato al commerciante che la transazione è stata sottoposta alla procedura di storno a causa di frode. Alcuni esempi di codici motivo includono 6005 e 6041 di Discover. Per gli storni parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK_REPRESENTMENT Indica che la transazione è stata avviata la procedura di contestazione a causa di frode e che il commerciante ha scelto di presentare una rappresentazione. Alcuni esempi di motivi includono 6005 e 6041 di Discover. Per gli storni parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK_REVERSE Indica che la transazione ha subito uno storno per frode che era illegittimo ed è stato annullato di conseguenza. Per gli storni 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 annullato. 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 Annotare le valutazioni.

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

Passaggi successivi