Primeros Pasos - Android

Comienza integrando el SDK de iOS 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: 2.1.1

Requisitos

Paso 1: Revisar los Requisitos para Utilizar el SDK

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

  • Tu proyecto debe usar una versión mínima de la API 24 de android o superior
  1. Conocimientos en desarrollo Android con Kotlin o Java.

  2. Una cuenta activa en DEUNA. (Para obtener una, contacta a [email protected])

  3. Credenciales válidas de DEUNA. (Solicítalas en [email protected])

  4. Configuraciones mínimas en tu proyecto Android:

    • La SDK DEUNA Android precisa que su minSdkVersion sea 24 o superior.
    • Tu proyecto debe tener habilitado Java 8 y usar AndroidX en lugar de bibliotecas de soporte anteriores.
    • La versión de Android-gradle-plugin debe ser 4.0.0 o superior.

Instalación

Paso 2: Configurar el Archivo build.gradle

En tu proyecto Android, abre el archivo app/build.gradle. Tu proyecto debe usar una versión mínima de la API 24 de Android o superior.

android {
   ...
    defaultConfig {
      ...
        minSdk 24 // O superior
      ...
    }
}

Paso 3: Agregar las Dependencias

Agrega las siguientes dependencias en el archivo build.gradle de tu proyecto:

dependencies {
   .
   .
   .
   implementation 'com.squareup.retrofit2:retrofit:2.9.0'
   implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'
   implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
   implementation 'com.deuna.maven:deunasdk:2.1.1'
}

Sincroniza tu proyecto y con esto ya tienes agregado el SDK de DEUNA en tu proyecto. Te recomendamos probar las funciones del SDK en un entorno de desarrollo para validar su correcto funcionamiento antes de lanzar tu aplicación.

Inicialización

Paso 4: Inicializa el SDK

Para usar el SDK necesitas inicializar el SDK o crear una instancia de la clase DeunaSDK

Mediante Inicialización

// Inicializa el SDK mediante la creación de un singleton
DeunaSDK.initialize(
    environment = Environment.SANDBOX, // Ambiente de pruebas (Environment.SANDBOX) o producción (Environment.PRODUCTION)
    publicApiKey = "YOUR_PUBLIC_API_KEY" // Llave pública proporcionada por DEUNA
)

// Ahora puedes usar el SDK mediante el uso de una instancia compartida de la clase DeunaSDK
DeunaSDK.shared

// Ejemplo
DeunaSDK.shared.initCheckout(...)

Creación de una Instancia

val deunaSDK = DeunaSDK(
   environment = Environment.SANDBOX, // Ambiente de pruebas (Environment.SANDBOX) o producción (Environment.PRODUCTION)
   publicApiKey = "YOUR_PUBLIC_API_KEY" // Llave pública proporcionada por DEUNA
)
// Uso del SDK
deunaSDK.initCheckout(...)

Seleccionar el Componente que Deseas Utilizar

Paso 5: Elige la Integración

Actualmente, los SDK móviles permiten usar los siguientes componentes:

Widget de Pagos

El Widget de Pagos 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 Widget de Pagos.

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 del Widget para Guardar Tarjetas.

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