Primeros Pasos

Comienza integrando el SDK Web de DEUNA en tu aplicación con esta guía paso a paso. Revisa los requisitos, configura e instala el SDK, y selecciona la integración que mejor se adapte a tus necesidades.

Versión Estable: 1.0.0

Requisitos

Paso 1: Revisar los Requisitos para Utilizar el SDK

Para utilizar el SDK Web de DEUNA, debes cumplir con los siguientes requisitos:

Conocimientos de desarrollo web con JavaScript.
Una cuenta activa en DEUNA. (Crea una contactando a [email protected])
Credenciales válidas de DEUNA. (Solicítalas en [email protected])

Al cumplir con estos requisitos, estarás preparado para instalar y comenzar a utilizar el SDK DEUNA en tu aplicación para habilitar funcionalidades de pago seguras y eficientes. Siempre recuerda seguir las mejores prácticas de seguridad y privacidad al manejar información financiera de los usuarios.

Instalación

Paso 2: Agregar el SDK Web de DEUNA a tu proyecto

NOTA: Actualmente el SDK Web de DEUNA únicamente se puede instalar via CDN.

Carga nuestro SDK por medio de la URL oficial para el ambiente deseado. Como buena practica, procura usar nuestro CDN para alta disponibilidad y no desde tu propio servidor. El atributo crossorigin brinda soporte para CORS, definiendo como el elemento script maneja llamadas de origin cruzado.

Agrega el siguiente script en tu archivo html

<script crossorigin  src="https://cdn.deuna.io/web-sdk/v1.0/index.js"></script>

También puedes agregar el SDK de DEUNA de forma dinámica con JavaScript. A continuación te mostramos un ejemplo.

if (typeof DeunaSDK === "undefined") { // si el SDK de DEUNA aun no se encuentra agregado
    var script = document.createElement("script");
    script.src = "https://cdn.deuna.io/web-sdk/v1.0/index.js";
    script.onload = function() {
       // Initicializar el SDK de DEUNA y
       // mostrar un widget
    };
    document.head.appendChild(script);
} else {
    //  mostrar un widget
}

Inicialización

Paso 3: Inicializa el SDK

Para usar el SDK, necesitas crear una instancia de la clase DeunaSDK.

await DeunaSDK.initialize({
  publicApiKey: "YOUR_PUBLIC_API_KEY", // Llave pública proporcionada por DEUNA
  environment: "sandbox",// Ambiente de pruebas (sandbox) o producción (production)
});

Seleccionar el Componente que Deseas Utilizar

Paso 4: Elige la Integración

Actualmente, el SDK Web permiten usar los siguientes componentes:

Payment Widget

El Payment Widget permite a los usuarios realizar pagos de forma rápida y segura directamente desde tu aplicación. Con este componente, puedes integrar un flujo de pago completo en tu app.

Para más detalles, consulta la documentación del Payment Widget.

También puedes integrar el payment widget sin usar nuestro SDK Web (No recomendado). Consulta la documentación aquí.

Widget de Checkout

Permite al comercio implementar un checkout completo incluyendo manejo de usuarios, OTP, información de envío y pagos. Esta integración simplifica el proceso de checkout en tu aplicación.

Para más detalles, consulta la documentación del Widget de Checkout.

Widget para Guardar Tarjetas (Vault Widget)

Este componente permite a los usuarios guardar tarjetas de forma segura para futuras transacciones. Es ideal para aplicaciones que requieren pagos recurrentes o que desean simplificar el proceso de pago para los usuarios.

Para más detalles, consulta la documentación de la bóveda de pagos.

También puedes integrar el Vault widget sin usar nuestro SDK Web (No recomendado). Consulta la documentación aquí.

También puedes integrar el Click To Pay widget sin usar nuestro SDK Web (No recomendado). Consulta la documentación aquí.

Al seleccionar uno de estos componentes, podrás continuar con el proceso de integración siguiendo las instrucciones específicas proporcionadas en los enlaces.