OTP es otra capa de protección en línea contra el fraude financiero.
Esta funcionalidad se encuentra disponible para los siguientes modelos:
☑ Adquirente
☑ Agregador
Por favor contáctanos para activar OTP en tu comercio.
Una one-time password (OTP) o autenticación con contraseña de un solo uso (también conocida como clave dinámica), es una contraseña válida por una sola transacción. Su finalidad es reducir el fraude y, de este modo, proveer seguridad extra a los pagos en línea de tu negocio.Considera utilizar OTP cuando tu comercio tenga una cantidad sustancial de fraude o proceses transacciones particularmente sensibles o de altos montos, ya que esto podría incurrir en una menor conversión debido a que se agregan pasos al proceso de pago.Podrás configurar para qué tipo de transacciones se solicitará la validación mediante OTP; por ejemplo, cuando el monto de la transacción supere un cierto umbral.
Esta característica está solamente disponible para integraciones Web en pagos únicos con tarjeta.
Revisa a continuación la disponibilidad de la autenticación OTP con los modelos de afiliación e integración disponibles en Kushki.
La autenticación OTP se encuentra disponible en los siguientes métodos de integración:
Soporta ✅
No soporta ❌
Integración con Shopify
Integración iOS (SDK)
Integración con Adobe Commerce
Integración Android (SDK)
Integración con Smartlink
Integración con Kajita
Integración con botón de pago
Integración vía API
Integración Kushki.js
Integración Kushki.js Hosted Fields
Importante
Ten en cuenta que, debido a nuestras políticas de riesgo, los medios de pago disponibles y el tipo de integración pueden variar al momento en que formalices la afiliación. Te indicaremos cómo proceder en caso de que este proceso aplique para tu comercio.
Luego de que el usuario completa el formulario y haga clic en el botón para pagar, se le realizará un pequeño cobro de un monto aleatorio de tres dígitos a su tarjeta (entre 1.86 y 6.99 PEN). El monto cobrado deberá ser ingresado por el usuario para autenticar la transacción. Por lo general el usuario podrá verificar este monto en las transacciones de su cuenta o mediante el servicio de alertas y notificaciones de su banco, en caso de estar disponible. Este cobro será anulado de manera automática en un par de minutos.Una vez el pagador consulta el monto cobrado, deberá ingresar los tres dígitos de este en una interfaz que le presentarás a tus usuarios para validar la transacción. El siguiente es un ejemplo de la interfaz y el mensaje que puedes presentar para capturar el monto de validación:
Para tomar en consideración
La OTP expira luego de 10 minutos.
El usuario tendrá 3 intentos para ingresar una OTP válida. En caso de que todos sean inválidos, al tercer intento se aprobara el OTP (incluso si el dato ingresado es incorrecto), de esta forma el rechazo quedará asociado en la petición de cargo. Normalmente, con el código de rechazo K322 y el subcódigo K326.
Sigue nuestras instrucciones para Kajita descritas en nuestra guía para aceptar pagos con tarjeta.Una vez que configures OTP para tu comercio, Kajita preguntará por la OTP de manera automática para cada intento de pago. No es necesario que realices nada más.
Sigue nuestras instrucciones para Kushki.js descritas en nuestra guía para aceptar pagos con tarjeta.Ahora, antes de enviar los datos al endpoint en tu backend debemos recoger la OTP desde el usuario y validarla.Cuando OTP está activado, la respuesta obtenida desde el método requestToken() se verá de esta manera:
Una vez obtenida la respuesta de requestToken(), necesitarás desplegar un campo en tu formulario para recoger la OTP del usuario.Utilizando la OTP recogida del usuario junto con secureId obtenido desde requestToken, deberás ejecutar el método requestSecureServiceValidation() para autenticar la OTP y obtener el código para enviarlo a tu back-end.
Si necesitas validar el código OTP, puedes utilizar el método onOTPValidation() en la instancia de tu tarjeta. Se ejecuta cuando se ingresa un valor en el campo OTP para validar el código. Este método devuelve tres callbacks (onSuccess, onError y onRequired), las cuales permitirán identificar el estatus de la validación OTP en los campos de lado del servidor.Para implementar la validación OTP, primero es requerido agregar un contenedor div con el id otp_id dentro de tu aplicación para desplegar el campo para ingresar el valor del OTP.
Nota: Se disparará la solicitud para la validación OTP automáticamente al ingresar 3 dígitos en el campo.
En segundo lugar, es necesario hacer referencia al contenedor otp_id dentro de tu instancia de CardOptions.
Por último, llama al método onOTPValidation() el cuál indicará si es necesario o no realizar la validación a través de un callback (onSuccess, onError o onRequired). En caso de que se requiera la validación, se desplegará el campo con el id otp_id para que el usuario ingrese la información requerida.
Existen tarjetas de prueba que puedes utilizar en el ambiente UAT para asegurarte de que tu integración está lista. Úsalas con cualquier CVV, código postal y fecha de expiración futura.
Transacción aprobada: 5451951574925480
Transacción declinada en solicitud de token (front-end): 4574441215190335
Transacción declinada en solicitud de cobro de OTP (front-end): 4349003000047015
Sigue las pautas descritas en nuestra guía para aceptar pagos con tarjeta.Sumado a las pautas descritas en la guía, si estas utilizando Kushki.js, valida también lo siguiente:
Existe un mensaje explicando OTP.
El campo de OTP aparece al hacer clic en pagar.
El campo de OTP es requerido.
El campo de OTP solo acepta números.
El campo de OTP permite exactamente 3 dígitos.
El logo de Kushki debe ser visible para el cliente. Puedes encontrar nuestro logo en varios formatos aquí.
