Remedies

Recupera transacciones legítimas que rechazamos por seguridad y aumenta las chances de aprobación en el próximo intento de tu cliente.

Introducción

Cuando rechazamos una transacción por sospecha de fraude (status_detail=REJECTED_FRAUD), muchas veces la operación era efectivamente legítima y tu cliente la reclama como propia. Sin una forma de corregir ese rechazo, el próximo intento vuelve a chocar con la misma barrera de seguridad y la experiencia de tu cliente se deteriora.

Un remedy es una medida que aplicas sobre una transacción rechazada para registrarla como legítima. Con esa señal, actualizamos las señales de riesgo asociadas a ese rechazo para que una operación similar posterior tenga más posibilidades de ser aprobada.

Con Remedies conviertes el reclamo de tu cliente en una acción concreta: consultas si la transacción es remediable, la marcas como propia y destrabas los intentos futuros sin fricción adicional, manteniendo los controles de prevención de fraude.

Alcance

Remedies aplica a todos los países donde operamos y a todos los productos (crédito y débito, tarjetas virtuales y físicas).

No todas las transacciones son remediables. Una transacción admite remedy solo cuando cumple con todos los requisitos de la sección siguiente.

Requisitos

Para aplicar el remedy, la transacción debe cumplir con estas 3 condiciones:

Requisito	Descripción
Resuelta como remediable	Además de haber sido rechazada por fraude, nuestro equipo de Fraude tiene que haberla clasificado como remediable. Las reglas que definen qué rechazos son remediables las controla nuestro equipo de Fraude. Puedes verificarlo con el endpoint de consulta de elegibilidad.
Menos de 30 días de antigüedad	La transacción tiene que tener menos de 30 días desde que ocurrió.
Pertenece a quien la remedia	La transacción tiene que pertenecer al cliente que solicita el remedy.

Si la transacción no cumple con alguno de estos requisitos, te lo indicaremos en la respuesta del endpoint con el código de error correspondiente.

Límite de monto diario por usuario

El remedy no reemplaza los límites que configuraste. El límite de monto diario de transacciones aprobadas por usuario es un freno que se mantiene aun después de aplicar un remedy: si tu cliente ya alcanzó ese límite, el nuevo intento se rechaza por ese motivo.

Te recomendamos verificar que tengas configurado este límite en la sección Affinity Groups del Dashboard. Así limitas el monto total que un mismo usuario puede acumular en aprobaciones por día, de acuerdo con tu estrategia de riesgo.

Remediar una transacción no garantiza la aprobación del siguiente intento. El nuevo intento sigue sujeto al límite diario por usuario y al resto de los controles.

Funcionamiento

Rechazamos una transacción por sospecha de fraude (REJECTED_FRAUD) y, según las reglas de Fraude, la clasificamos como remediable.
Tu cliente reclama la operación como propia a través de tu canal de soporte.
Consultas si la transacción es remediable con el endpoint Consultar elegibilidad de remedy.
Si es remediable, verificas con tu cliente que la transacción es legítima.
Envías una solicitud autenticada por Token al endpoint POST /fraud/remedy con el ID de la transacción.
Registramos el remedy y te devolvemos una respuesta síncrona con el resultado.
Actualizamos las señales de riesgo para que una operación similar posterior de tu cliente tenga más chances de ser aprobada.
Le pides a tu cliente que vuelva a intentar la compra. El nuevo intento no se rechaza por el motivo de fraude que remediaste, salvo que alcance el límite diario por usuario u otro control.

Diagrama de secuencia del flujo completo: transacción rechazada por fraude → cliente reclama a tu canal de soporte → consulta de elegibilidad (GET) → confirmación con el cliente → remedy (POST) → nuevo intento del cliente.

El resultado del remedy es siempre la respuesta síncrona del endpoint. No enviamos un webhook ni una notificación posterior.

Cómo empezar

Para usar Remedies, tu integración debe tener habilitado el permiso fraud:remedy en Auth0. Para solicitarlo, crea un ticket desde el Dashboard indicando que necesitas el scope fraud:remedy.

Cómo consultar si una transacción es remediable

Antes de pedirle a tu cliente que confirme la compra, usa el endpoint Consultar elegibilidad de remedy para verificar si la transacción cumple con los requisitos de remedy. Así evitas contactar a tu cliente por una transacción que lo admite.

Consulta el detalle de la request y la respuesta en la API Reference.

Cómo aplicar un remedy

El endpoint POST /fraud/remedy requiere el scope fraud:remedy en Auth0 y una request autenticada por Token.

Campos de la request

Campo	Descripción	Ejemplo
ctx_id	ID de la transacción sobre la que aplicas el remedy. Obligatorio.	ctx-12345
remedy_reason	Razón del remedy. Opcional.	Transacción validada con el usuario

Ejemplo de request

Ejemplo de respuesta

Cuando registramos el remedy, te devolvemos un 201 con el ID del remedy creado.

Errores

Si no podemos registrar el remedy, te devolvemos uno de estos códigos:

Código	Significado
`400`	El cuerpo de la solicitud es inválido o falta el `ctx_id`.
`401`	La request no está autorizada.
`403`	La transacción no pertenece al cliente solicitante.
`409`	Ya existe un remedy para esta transacción.
`422`	La transacción no admite remedy (no es aplicable o tiene más de 30 días).
`500`	Error interno.
`502`	Un servicio externo no está disponible. No registramos el remedy y puedes reintentar.

Preguntas frecuentes

¿Aplicar un remedy garantiza que la próxima transacción se apruebe?

No. El remedy actualiza las señales de riesgo asociadas al rechazo para que una operación similar posterior tenga más chances de ser aprobada, pero no fuerza la aprobación. La transacción sigue pasando por el resto de los controles, incluido el límite de monto diario por usuario.

¿El límite de monto diario por usuario se aplica también a las transacciones remediadas?

Sí. El límite de monto diario de transacciones aprobadas por usuario (configurable en Affinity Groups del Dashboard) sigue vigente después de un remedy. Si tu cliente ya lo alcanzó, el nuevo intento se rechaza aunque hayas remediado la transacción anterior.

¿Cómo sé si una transacción es remediable?

Con el endpoint Consultar elegibilidad de remedy puedes consultar si la transacción admite remedy antes de contactar a tu cliente.

¿Puedo remediar cualquier transacción rechazada?

No. La transacción tiene que estar clasificada como remediable por nuestro equipo de Fraude, tener menos de 30 días y pertenecer a tu cliente. Si no cumple con alguno de estos requisitos, te devolvemos un error 422.

¿Puedo aplicar más de un remedy sobre la misma transacción?

No. Cada transacción admite un único remedy. Si ya existe uno, te devolvemos un error 409.

¿Es obligatorio enviar la razón del remedy?

No. El campo remedy_reason es opcional. De todos modos, te recomendamos enviarlo para dejar registro del motivo por el que validaste la transacción.

¿Recibo una notificación cuando se procesa el remedy?

No. El resultado es siempre la respuesta síncrona del endpoint. No enviamos webhooks ni notificaciones posteriores.

¿Qué hago si recibo un error 502?

Un 502 indica que un servicio externo no estaba disponible y que no registramos el remedy. Puedes reintentar la solicitud.