Anota las evaluaciones con eventos de transacciones

Las anotaciones de eventos de transacciones en Fraud Defense te permiten proporcionar datos del ciclo de vida de los pagos posteriores a la evaluación, como liquidaciones, devoluciones de cargos y reembolsos. Estos comentarios te ayudan a definir mejor el modelo específico de tu sitio y mejoran los veredictos de fraude futuros.

Para lograr el mejor rendimiento, Transaction defense necesita visibilidad de los eventos del ciclo de vida de pagos para transacciones. Por lo tanto, te recomendamos que envíes anotaciones para las evaluaciones que creaste con datos de transacciones. Por ejemplo, puedes proporcionar la información de la transacción a Transaction defense como un evento de transacción en las siguientes situaciones:

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

  • El comercio emite un reembolso.

  • La entidad emisora del pago presenta un reembolso.

Para obtener más información sobre cómo enviar anotaciones, consulta Cómo anotar evaluaciones.

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

Después de crear una evaluación con los datos de transacciones incluidos, Transaction defense devuelve un veredicto y un nombre de evaluación. Anota la evaluación con eventos de transacciones en las siguientes etapas importantes del ciclo de vida del pago cuando ocurran:

Tipo de evento Descripción Ejemplo del motivo Ejemplo de valor
MERCHANT_APPROVE | MERCHANT_DENY Cuando decidas si la transacción debe poder continuar. 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 realice. 82 (un código de motivo significa que el CVV era incorrecto) N/A
CHARGEBACK Cuando se devuelven los cargos de la transacción. Card Reported Stolen 20 (representa una devolución del cargo parcial de 20 unidades de moneda)

Junto con el tipo de evento CHARGEBACK, incluye el código de motivo de la devolución del cargo que proporcionó la entidad emisora de la tarjeta con el campo reason. Además, incluye el importe monetario de la devolución de cargo en el campo value si se devolvió el cargo de la transacción de forma parcial.

En el campo reason del evento de transacción, incluye términos aclaratorios para proporcionar más contexto sobre el motivo del evento o proporciona códigos de motivo que se obtengan directamente de la red de pagos o de la entidad emisora de la tarjeta. Estos términos y códigos difieren según el tipo de evento.

En la siguiente tabla, se especifica la lista completa de tipos de eventos de transacciones:

Motivo de la anotación Descripción
MERCHANT_APPROVE Indica que el comercio aprobó la transacción. Los motivos que se incluyen pueden contener términos como IN_HOUSE, ACCERTIFY, CYBERSOURCE o MANUAL_REVIEW.
MERCHANT_DENY Indica que la transacción se rechazó y concluyó debido a los riesgos que detectó el comercio. Los motivos que se incluyen pueden contener 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 realizó correctamente.
AUTHORIZATION_DECLINE Indica que falló el intento de autorización con la entidad emisora de la tarjeta. Entre los motivos que se incluyen, se encuentran el 54 de Visa, que indica que la tarjeta venció, o el 82, que indica que el CVV es incorrecto.
PAYMENT_CAPTURE Indica que la transacción se completó porque se liquidaron los fondos.
PAYMENT_CAPTURE_DECLINE Indica que no se pudo completar la transacción porque no se liquidaron los fondos.
CANCEL Indica que se canceló la transacción. Especifica el motivo de la cancelación. Por ejemplo, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Indica que el comercio recibió una consulta de devolución del 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 del cargo por fraude y se envíe una notificación formal de devolución del cargo.
CHARGEBACK_ALERT Indica que el comercio recibió una alerta de devolución del cargo debido a un fraude en la transacción. Se inicia el proceso de resolución de la disputa sin involucrar a la red de pagos.
FRAUD_NOTIFICATION Indica que se emitió una notificación de fraude para la transacción, enviada por el banco emisor del instrumento de pago porque la transacción parece ser fraudulenta. Te recomendamos que incluyas datos de TC40 o SAFE en el campo reason para este tipo de evento. Para las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
CHARGEBACK Indica que la red de pagos informa al comercio que la transacción ingresó al proceso de devolución del cargo debido a un fraude. Algunos ejemplos de códigos de motivo son 6005 y 6041 de Discover. Para las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
CHARGEBACK_REPRESENTMENT Indica que la transacción ingresó al proceso de devolución del cargo debido a un fraude y que el comercio decidió ingresar una representación. Algunos ejemplos de motivos son 6005 y 6041 de Descubre. Para las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
CHARGEBACK_REVERSE Indica que la transacción tuvo una devolución del cargo por fraude que fue ilegítima y, como resultado, se revirtió. Para las devoluciones de cargo parciales, te recomendamos que incluyas un importe en el campo value.
REFUND_REQUEST Indica que el comercio recibió un reembolso por una transacción completada. Para los reembolsos parciales, te recomendamos que incluyas un importe en el campo value. Ejemplo de motivo: FRAUD.
REFUND_DECLINE Indica que el comercio recibió una solicitud de reembolso para esta transacción, pero la rechazó. Para los reembolsos parciales, te recomendamos que incluyas un importe en el campo value. Ejemplo de motivo: FRAUD.
REFUND Indica que el comercio reembolsó la transacción completada. Para los reembolsos parciales, te recomendamos que incluyas un importe en el campo value. Ejemplo de motivo: PROACTIVE_FRAUD.
REFUND_REVERSE Indica que el comercio reembolsó la transacción completada y que se revirtió este reembolso. Para los reembolsos parciales, te recomendamos que incluyas 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 detalles, consulta Anota evaluaciones.

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

¿Qué sigue?