Annotare le valutazioni con gli eventi di transazione

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

Per ottenere le migliori prestazioni, la funzionalità di prevenzione delle attività fraudolente di reCAPTCHA deve poter analizzare gli eventi del ciclo di vita dei pagamenti per le transazioni. Pertanto, ti consigliamo di inviare annotazioni per le valutazioni create con i dati sulle transazioni. Ad esempio, puoi fornire le informazioni sulle transazioni a reCAPTCHA Fraud Prevention 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 Annotare 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 cambia lo stato di una transazione.

Dopo aver creato una valutazione con i dati delle transazioni inclusi, reCAPTCHA Fraud Prevention restituisce un verdetto e un nome della valutazione. Aggiungi annotazioni alla valutazione con gli eventi di transazione quando si verificano nelle seguenti fasi importanti del ciclo di vita del pagamento:

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 del motivo dello storno di addebito fornito dall'emittente della carta utilizzando il campo reason. Inoltre, includi l'importo monetario dell'addebito nel campo value se la transazione è stata addebitata parzialmente.

Nel campo dell'evento di transazione reason, includi termini chiarificatori per fornire maggiori informazioni sul motivo dell'evento o fornisci codici motivo ottenuti direttamente dalla rete di pagamento o dall'emittente della carta. Questi termini e codici differiscono 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 aggiuntivi 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 a supporto 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 scetticismo o rischio.
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 54 di Visa, che indica che la carta è scaduta, o 82, che indica che il CVV non è corretto.
PAYMENT_CAPTURE Indica che la transazione è stata completata perché i fondi sono stati girati.
PAYMENT_CAPTURE_DECLINE Indica che la transazione non è stata completata perché i fondi non sono stati regolati.
CANCEL Indica che la transazione è 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 attività fraudolenta relativa alla transazione e che richiede informazioni aggiuntive prima che lo storno di addebito per attività fraudolenta sia stato ufficialmente emesso e che sia stata inviata una notifica formale di storno di addebito.
CHARGEBACK_ALERT Indica che il commerciante ha ricevuto un avviso di storno di addebito per attività fraudolenta relativa alla transazione. Viene avviata la procedura di risoluzione della controversia senza coinvolgere la rete 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. Per questo tipo di evento, consigliamo di includere i dati TC40 o SAFE nel campo reason. Per i riaccreditamenti parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK Indica che la rete di pagamento ha informato il commerciante che la transazione è entrata nella procedura di storno di addebito a causa di attività fraudolenta. Alcuni esempi di codici motivo sono 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 inserita nella procedura di storno di addebito a causa di attività fraudolenta e che il commerciante ha scelto di inserire la rappresentanza. Alcuni esempi di motivi sono 6005 e 6041 di Discover. Per gli storni parziali, ti consigliamo di includere un importo nel campo value.
CHARGEBACK_REVERSE Indica che per la transazione è stato effettuato un storno di addebito per attività fraudolenta il quale è stato ritenuto illegittimo e di conseguenza è stato annullato. 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, vedi 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