---
title: "3D Secure vía API"
slug: "technical-documentation-template"
updated: 2024-11-27T20:05:27Z
published: 2024-11-27T20:05:27Z
canonical: "docs.davipay.com/technical-documentation-template"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.davipay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 3D Secure vía API

## 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>:**

```xml
<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:

```javascript
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

```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**

```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, s**olicites 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 ticke**t en tu [dashboard](https://dashboard.epayco.com/login) de ePayco o contactando a tu asesor comercial.

### **Recursos relacionados**

Tutorial del motor antifraude ePayco Control: [https://docs.epayco.com/docs/reglas-2](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](https://docs.epayco.com/docs/reglas-3d-secure)