En esta página, se describe cómo anotar evaluaciones con eventos de transacción para definir mejor el modelo específico del sitio.
Para obtener el mejor rendimiento, la prevención de fraudes de reCAPTCHA necesita visibilidad de los eventos del ciclo de vida de los pagos de las 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 la Prevención de fraudes de reCAPTCHA 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 agregar anotaciones en las 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 (por ejemplo, cuando cambia el estado de una transacción).
Después de crear una evaluación con los datos de transacciones incluidos, la prevención de fraudes de reCAPTCHA muestra un veredicto y un nombre de la evaluación. Anota la evaluación con eventos de transacción en las siguientes etapas importantes del ciclo de vida de pago cuando se produzcan:
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 (que 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
proporciona la entidad emisora de la tarjeta a través del campo reason
. Además, incluye el importe cobrado en el campo value
si la transacción se devolvió 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 los 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 transacción:
Motivo de la anotación | Descripción |
---|---|
MERCHANT_APPROVE |
Indica que el comercio aprobó la transacción. Entre los motivos adjuntos, se pueden incluir 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
detectados por el comercio. Entre los motivos adjuntos, se 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 una sospecha o un riesgo. |
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 acompañan la tarjeta, se pueden incluir el 54 de Visa, que indica que la tarjeta está vencida, o 82 , que indica que el CVV es incorrecto.
|
PAYMENT_CAPTURE |
Indica que se completó la transacción 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 por la transacción, que 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 este tipo. |
CHARGEBACK_ALERT |
Indica que el comercio recibió una alerta de devolución del cargo debido a un fraude de la transacción. Se inicia el proceso de resolución de la disputa sin que se involucre 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. Recomendamos incluir datos de TC40 o SAFE en el campo reason para este tipo de evento. Para devoluciones de cargos parciales, te recomendamos que incluyas un importe en el campo value .
|
CHARGEBACK |
Indica que la red de pagos le informó al comercio que la transacción ingresó en el proceso de devolución del cargo debido a un fraude. Entre los ejemplos de código del motivo, se incluyen 6005 y 6041 de Descubre. Para las devoluciones de cargos parciales, te recomendamos que incluyas un importe en el campo value .
|
CHARGEBACK_REPRESENTMENT |
Indica que la transacción ingresó en el proceso de devolución del cargo debido a un fraude y que el comercio eligió realizar la representación. Algunos ejemplos de motivos incluyen 6005 y 6041 de Descubre. Para las devoluciones de cargos 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 se revirtió, como resultado. Para las devoluciones de cargos 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 del motivo: FRAUD .
|
REFUND_DECLINE |
Indica que el comercio recibió una solicitud de reembolso por esta
transacción, pero que la rechazó. Para los reembolsos parciales, te recomendamos que incluyas un importe en el campo value . Ejemplo del 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 del motivo: PROACTIVE_FRAUD .
|
REFUND_REVERSE |
Indica que el comercio reembolsó la transacción completada y que se revirtió. 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?
- Para obtener más información sobre las funciones de protección de las cuentas de usuario, consulta Funciones de protección de las cuentas de usuario.