Anotar evaluaciones con eventos de transacción

En esta página se describe cómo anotar evaluaciones con eventos de transacción para mejorar el modelo específico de su sitio.

Para obtener el mejor rendimiento, reCAPTCHA Fraud Prevention necesita visibilidad de los eventos del ciclo de vida de los pagos de las transacciones. Por lo tanto, le recomendamos que envíe anotaciones de las evaluaciones que haya creado con datos de transacciones. Por ejemplo, puede proporcionar la información de la transacción a reCAPTCHA Fraud Prevention como un evento de transacción en los siguientes casos:

  • El proveedor de pagos acepta o rechaza la transacción.

  • El comerciante emite un reembolso.

  • La entidad emisora del pago presenta un reembolso.

Para obtener más información sobre cómo enviar anotaciones, consulte el artículo Anotar evaluaciones.

Te recomendamos que hagas estas solicitudes automáticamente como parte de la lógica correspondiente de tu sistema cuando los datos estén disponibles, por ejemplo, cuando cambie el estado de una transacción.

Después de crear una evaluación con datos de transacción incluidos, reCAPTCHA Fraud Prevention devuelve un veredicto y un nombre de evaluación. Anota la evaluación con eventos de transacción en las siguientes fases importantes del ciclo de vida del pago cuando se produzcan:

Tipo de evento Descripción Ejemplo de motivo Ejemplo de valor
MERCHANT_APPROVE, MERCHANT_DENY Cuando decidas si la transacción debe completarse. IN_HOUSE N/A
AUTHORIZATION, AUTHORIZATION_DECLINE Cuando envías la transacción para que se procese, la entidad emisora de la tarjeta decide si permite que se lleve a cabo. 82 (un código de motivo que indica que el CVV era incorrecto) N/A
CHARGEBACK Cuando se devuelve el cargo de la transacción. Card Reported Stolen 20 (que representa una devolución parcial de 20 unidades de moneda)

Junto con el tipo de evento CHARGEBACK, incluya el código de motivo de la devolución de cargo proporcionado por la entidad emisora de la tarjeta mediante el campo reason. Además, incluya el importe monetario devuelto en el campo value si la transacción se ha devuelto parcialmente.

En el campo reason del evento de transacción, incluya términos aclaratorios para proporcionar más contexto sobre el motivo del evento o proporcione códigos de motivo que se obtengan directamente de la red de pago o de la entidad emisora de la tarjeta. Estos términos y códigos varían en función del tipo de evento.

En la siguiente tabla se especifica la lista completa de tipos de eventos de transacción:

Motivo de la anotación Descripción
MERCHANT_APPROVE Indica que el comerciante ha aprobado la transacción. Los motivos correspondientes pueden incluir términos como IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MERCHANT_DENY Indica que la transacción se ha rechazado y finalizado debido a los riesgos detectados por el comerciante. Los motivos pueden incluir términos como IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MANUAL_REVIEW Indica que una persona está evaluando la transacción debido a sospechas o riesgos.
AUTHORIZATION Indica que el intento de autorización con la entidad emisora de la tarjeta se ha realizado correctamente.
AUTHORIZATION_DECLINE Indica que no se ha podido completar la autorización con la entidad emisora de la tarjeta. Los motivos pueden incluir 54 de Visa, que indica que la tarjeta ha caducado, o 82, que indica que el CVV es incorrecto.
PAYMENT_CAPTURE Indica que la transacción se ha completado porque los fondos se han liquidado.
PAYMENT_CAPTURE_DECLINE Indica que no se ha podido completar la transacción porque los fondos no se han liquidado.
CANCEL Indica que la transacción se ha cancelado. Especifica el motivo de la cancelación. Por ejemplo, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Indica que el comerciante ha recibido una consulta sobre una devolución de cargo debido a un fraude en la transacción, en la que se solicita información adicional antes de que se emita oficialmente una devolución de cargo por fraude y se envíe una notificación formal de devolución de cargo.
CHARGEBACK_ALERT Indica que el comerciante ha recibido una alerta de devolución de cargo por fraude en la transacción. Se inicia el proceso de resolución de la disputa sin involucrar a la red de pago.
FRAUD_NOTIFICATION Indica que se ha emitido una notificación de fraude para la transacción, enviada por el banco emisor del instrumento de pago, porque la transacción parece fraudulenta. Te recomendamos que incluyas datos de TC40 o SAFE en el campo reason de este tipo de evento. En el caso de las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
CHARGEBACK Indica que la red de pagos informa al comerciante de que la transacción ha iniciado el proceso de devolución de cargo debido a un fraude. Algunos ejemplos de códigos de motivo son 6005 y 6041 de Discover. En el caso de las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
CHARGEBACK_REPRESENTMENT Indica que la transacción ha entrado en el proceso de devolución de cargo debido a un fraude y que el comerciante ha decidido presentar una nueva reclamación. Algunos ejemplos de motivos son 6005 y 6041 de Discover. En el caso de las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
CHARGEBACK_REVERSE Indica que la transacción ha tenido una devolución de cargo fraudulenta que era ilegítima y se ha revertido como resultado. En el caso de las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
REFUND_REQUEST Indica que el comerciante ha recibido un reembolso por una transacción completada. En el caso de los reembolsos parciales, le recomendamos que incluya un importe en el campo value. Ejemplo de motivo: FRAUD.
REFUND_DECLINE Indica que el comerciante ha recibido una solicitud de reembolso para esta transacción, pero la ha rechazado. En el caso de los reembolsos parciales, le recomendamos que incluya un importe en el campo value. Ejemplo de motivo: FRAUD.
REFUND Indica que el comerciante ha reembolsado la transacción completada. En el caso de los reembolsos parciales, te recomendamos que incluyas un importe en el campo value. Ejemplo de motivo: PROACTIVE_FRAUD.
REFUND_REVERSE Indica que el comerciante ha reembolsado la transacción completada y que este reembolso se ha anulado. En el caso de los reembolsos parciales, le recomendamos que incluya un importe en el campo value.

En el siguiente ejemplo se muestra una carga útil de anotación de muestra que contiene un evento de transacción. Para obtener más información, consulta Anotar evaluaciones.

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

Siguientes pasos