.png){kind=logo}
3D Secure vía API
- 27 Nov 2024
- 2 Minutes to read
- Contributors
- Print
- DarkLight
3D Secure vía API
- Updated on 27 Nov 2024
- 2 Minutes to read
- Contributors
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Guía para implementar 3D Secure para transacciones vía API
Descripción del desarrollo
Con el objetivo de ofrecer una experiencia de pago más segura y confiable, hemos integrado la autenticación 3D Secure directamente en nuestras transacciones vía API. Esta innovadora solución mejora significativamente la protección contra fraudes, garantizando la verificación del titular de la tarjeta en tiempo real sin afectar la fluidez del proceso de pago.
Al implementar 3D Secure en transacciones API, proporcionamos a los comercios y desarrolladores la posibilidad de habilitar un nivel adicional de seguridad en sus flujos de integración, para los comercios que no posean integración de nuestro web checkout (el cual también cuenta con 3D secure). Nuestra implementación se adapta de manera flexible a diferentes escenarios de uso, optimizando la experiencia tanto para clientes como para negocios.
Características clave
Protección avanzada contra fraudes: Validación directa con emisores de tarjetas en conformidad con PSD2 y otros estándares globales.
Diseño API-first: Integración optimizada para desarrolladores, garantizando una rápida implementación en cualquier entorno.
Compatibilidad dinámica: Ajuste automático de la última versión de 3D Secure, asegurando cobertura universal.
Mejora de la tasa de aprobación: Reducción de contracargos y disputas, fortaleciendo la confianza del cliente en los pagos digitales.
Con esta implementación, damos un paso más hacia el futuro de los pagos digitales, combinando seguridad, agilidad y tecnología de punta. A continuación, encontrarás los pasos detallados para integrar esta funcionalidad en tu sistema:
1- Importar el script de 3D Secure
Para gestionar las solicitudes a la API de manera más eficiente, debes importar el script de validación 3ds. Agrega el siguiente código en tu archivo HTML, preferiblemente en la sección <head> o antes del cierre de la tiqueta <body>:
<script src="https://multimedia.epayco.co/general/3DS/validateThreeds.min.js"> 2- Preparar la data para la validación de 3D Secure
Después de ejecutar el endpoint para crear una transacción (payment/process) y recibas la respuesta (transactionData), debes verificar si contiene información de 3DS.
Ejemplo de llamado a la API:
const paymentResponse = await axios.post(`${API_BASE_URL}/payment/process`, formObject,
{
headers: {
Authorization: `Bearer ${token}`
}
});
const transactionData = paymentResponse.data.data.transaction.data; Si es así, continua los siguientes pasos. estos pasos:
1. Verifica si el objeto transactionData incluye la clave 3DS.
2. Crea un nuevo objeto data3DS con la siguiente estructura:
Ejemplo en Javascript
if (transactionData['3DS'] !== undefined) {
const data3DS = {
"franquicia": transactionData.franquicia,
"3DS": transactionData['3DS'],
"ref_payco": transactionData.ref_payco,
"cc_network_response": transactionData.cc_network_response
};
// En este punto enviara el objeto data3DS al método de
validación
validate3ds(data3DS);
} 3- Manejar los eventos de la validación 3D Secure
La librería emitirá eventos durante el proceso de validación. Es importante capturar estos eventos utilizando el siguiente código:
Javascript
window.addEventListener('message', function(event) {
if (event.data.success || event.data.message) {
console.log("Se obtuvo la ref_payco. Consulta la transacción para
verificar su estado.");
// Aquí puedes implementar la lógica para consultar el estado de
la transacción y continuar con el flujo de pago {
}
}); 4- Confirmar configuración activa
Asegúrate de, que luego de realizar esta implementación, solicites la activación de la configuración 75 en el sistema, ya que es necesario para habilitar correctamente esta funcionalidad. Esto podrás realizarlo mediante la creación de un ticket en tu dashboard de ePayco o contactando a tu asesor comercial.
Recursos relacionados
Tutorial del motor antifraude ePayco Control: https://docs.epayco.com/docs/reglas-2
Tutorial de configuración y activación de reglas de 3D Secure: https://docs.epayco.com/docs/reglas-3d-secure
Was this article helpful?