Annota le valutazioni con eventi di transazione

In questa pagina viene descritto come annotare le valutazioni con eventi di transazione per perfezionare il modello specifico del sito.

Per ottenere le migliori prestazioni, reCAPTCHA Fraud Prevention 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 sulla transazione a Fraud Prevention di reCAPTCHA 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 un rimborso.

Per scoprire di più su come inviare annotazioni, consulta Annotare le valutazioni.

Ti consigliamo di effettuare automaticamente queste richieste come parte 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, reCAPTCHA Fraud Prevention restituisce un esito e un nome della valutazione. Annota la valutazione con eventi di transazione nelle seguenti fasi importanti del ciclo di vita dei pagamenti 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/A
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/A
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 fornito dall'emittente della carta utilizzando il campo reason. Inoltre, includi l'importo monetario riaddebitato nel campo value se la transazione è stata parzialmente riaddebitata.

Nel campo dell'evento di transazione reason, includi dei termini chiari per fornire maggiore contesto sul motivo dell'evento oppure fornisci i codici del motivo che vengono ottenuti direttamente dalla rete 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 è stata approvata dal commerciante. che possono includere termini quali IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MERCHANT_DENY Indica che la transazione è stata rifiutata e completata a causa dei rischi rilevati dal commerciante. che possono includere termini quali IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MANUAL_REVIEW Indica che la transazione è in fase di valutazione da parte di una persona a causa di sospetto 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 da parte dell'emittente della carta non è andato a buon fine. I motivi possono includere 54 di Visa, che indica che la carta è scaduta, o 82, che indicano 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 a causa di attività fraudolenta relativa alla transazione, richiedendo ulteriori informazioni prima che venga emesso ufficialmente uno storno di addebito e che venga inviata una notifica formale di storno di addebito.
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 per risolvere la contestazione senza coinvolgere la rete di pagamento.
FRAUD_NOTIFICATION Indica che viene emessa una notifica di frode 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 viene informato dalla rete di pagamento che la transazione è entrata nella procedura di storno di addebito a causa di attività fraudolenta. Gli esempi di codice 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 attività fraudolente e che il commerciante ha scelto di rappresentare il suo rappresentante. Alcuni esempi di motivi includono 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 di conseguenza è stato 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 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