Primeros Pasos - Android
Comienza integrando el SDK de Android 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.7.0
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 22 de android o superior
-
Conocimientos en desarrollo Android con Kotlin o Java.
-
Una cuenta activa en DEUNA. (Para obtener una, contacta a [email protected])
-
Credenciales válidas de DEUNA. (Solicítalas en [email protected])
-
Configuraciones mínimas en tu proyecto Android:
- La SDK DEUNA Android precisa que su
minSdkVersion
sea 22 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.
- La SDK DEUNA Android precisa que su
Compatibilidad con dispositivos Huawei (HarmonyOS)
El SDK de DEUNA también es compatible con dispositivos Huawei con HarmonyOS 2.0 o superior.
Instalación
Paso 2: Agregar el repositorio JitPack
En tu archivo raíz settings.gradle
agrega el repositorio de jitpack en el bloque dependencyResolutionManagement
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven { url 'https://jitpack.io' } // <-- AGREGAR ESTA LINEA
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven { setUrl("https://jitpack.io") } // <-- AGREGAR ESTA LINEA
}
}
NOTA: Para proyectos android que no tienen el bloque
dependencyResolutionManagement
en el archivosettings.gradle
se debe agregar el repositorio de jitpack en el bloquerepositories
que se puede encontrar en el archivo raízbuild.gradle
o en el archivoapp/build.gradle
allprojects { repositories { ... maven { url 'https://jitpack.io' } // <-- AGREGAR ESTA LINEA } }
Paso 3: 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 22 de Android o superior.
android {
...
defaultConfig {
...
minSdk 22 // O superior
...
}
}
Paso 4: Agregar las Dependencias
Agrega las siguientes dependencias en el archivo app/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.github.deuna-developers:deuna-sdk-android:2.7.0' // DEUNA SDK
}
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.github.deuna-developers:deuna-sdk-android:2.7.0") // DEUNA SDK
}
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.
NOTA: Si estas actualizando el sdk de DEUNA de una versión previa a la 2.5.1 se recomienda limpiar el cache de Android Studio
Inicialización
Paso 5: 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 6: 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.
Updated 5 days ago