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, Fraud Prevention di reCAPTCHA deve avere visibilità agli eventi del ciclo di vita dei pagamenti per le transazioni. Pertanto, ti consigliamo Inviare annotazioni per le valutazioni che hai creato 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 la pagina 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. Annota la valutazione con gli eventi di transazione a seguenti fasi importanti del ciclo di vita dei pagamenti in cui 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 (ovvero uno storno di addebito parziale di 20 unità di valuta)

Insieme al tipo di evento CHARGEBACK, includi il codice del motivo dello storno di addebito che è stato fornito dall'emittente della carta utilizzando il campo reason. Includi inoltre l'importo monetario dell'addebito nel campo value se la transazione è stata addebitata parzialmente.

Nel campo dell'evento di transazione reason, includi i termini esplicativi per fornisci maggiore contesto sul motivo dell'evento o fornisci codici del motivo che sono ottenuti direttamente dalla rete di pagamento o dall'emittente della carta. I presenti termini e 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. La possono includere termini quali IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MERCHANT_DENY Indica che la transazione è stata rifiutata e completata a causa di rischi rilevato dal commerciante. I motivi aggiuntivi possono includere termini come 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 da parte dell'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. La possono includere la 54 di Visa, che indica che la carta è scaduto o 82 che indica che il CVV non è corretto.
PAYMENT_CAPTURE Indica che la transazione è stata completata perché i fondi sono stati risolto.
PAYMENT_CAPTURE_DECLINE Indica che la transazione non è stata completata 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 attività fraudolenta relativa alla transazione, con la richiesta di informazioni aggiuntive prima che lo storno di addebito per attività fraudolenta sia stato emesso ufficialmente e prima che venga 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. La procedura di risoluzione della controversia senza che coinvolga la rete di pagamento.
FRAUD_NOTIFICATION Indica che viene emessa una notifica di attività fraudolenta per la transazione, inviata da la banca emittente dello strumento di pagamento, in quanto la transazione sembra essere essere fraudolenti. 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 il commerciante viene informato dalla rete di pagamento che transazione è entrata nel processo di storno di addebito a causa di attività fraudolenta. Codice motivo esempi includono 6005 e 6041 di Discover. Per gli storni di addebito parziali, 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 di addebito parziali, consigliamo di includere un importo nel campo value.
CHARGEBACK_REVERSE Indica che la transazione ha subito un storno di addebito fraudolento 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 questo transazione, ma l'ha rifiutata. Per i rimborsi parziali, consigliamo di includere un importo nel campo value. Esempio di motivo: FRAUD.
REFUND Indica che la transazione completata è stata rimborsata dal commerciante. Per rimborsi parziali, ti consigliamo di includere un importo nella 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 una 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