Cómo funciona
- Agregas el módulo a tu app como una dependencia de Gradle, junto al Yuno SDK.
- Cuando la app inicia, el módulo se registra solo en el Yuno SDK. No hay código que escribir.
- Durante el checkout, el Yuno SDK consulta al backend qué proveedores aplican a la transacción y usa el módulo correspondiente: por ejemplo, recopila un fingerprint del dispositivo y lo adjunta al pago, o ejecuta el desafío de 3D Secure de forma nativa en lugar de en un WebView.
Módulos disponibles
https://yunopayments.jfrog.io/artifactory/snapshots-libs-release). Un módulo no fija una versión específica del Yuno SDK: tú controlas la versión de android-sdk, siempre que sea igual o superior al mínimo de la tabla. Netcetera requiere una configuración adicional (un segundo repositorio de Maven y un certificado de sandbox), que se explica en Netcetera 3DS (Android). Signifyd necesita el registro privado de Signifyd y tu propio token de Signifyd, como se explica en Antifraude de Signifyd (Android).
Instalación
Agrega los módulos que necesites al archivo de compilación del módulo de tu app, junto a la dependencia del Yuno SDK. Cada módulo ya incluye el SDK de su proveedor y sus propias dependencias, por lo que no necesitas nada más.- Groovy DSL
- Kotlin DSL
build.gradle:Activar un módulo
Cada módulo se registra solo en el Yuno SDK cuando se inicia el proceso de tu app, mediante Jetpack App Startup. No se requiere código: sigue inicializando el Yuno SDK exactamente como lo haces hoy.YunoRevolutPay cuando tu android-sdk es anterior a 2.24.0 y el módulo no pudo registrarse.
Si tu app deshabilita App Startup
Si tu app deshabilita App Startup
androidx.startup.InitializationProvider con tools:node="remove") para controlar por sí mismas el trabajo de inicio. En ese caso, los módulos no pueden registrarse por su cuenta. Ejecuta tú mismo sus inicializadores, una sola vez, antes de Yuno.initialize(...), usando la API manual de App Startup:Qué necesita cada módulo de tu app
Antifraude de ClearSale
- Envía a Yuno el id de sesión propio de ClearSale como
customer.device_fingerprintdel pago. No cambia nada en los datos que envías. - La recopilación se ejecuta cuando el comprador confirma el pago. Está limitada por el
timeoutconfigurado para el proveedor ClearSale en tu cuenta de Yuno (5 segundos por defecto). Mantén ese timeout por encima de 1 segundo; de lo contrario, la recopilación agota el tiempo y el pago continúa sin fingerprint. - Declara
INTERNET,ACCESS_NETWORK_STATEyACCESS_WIFI_STATE; se combinan con tu manifest automáticamente. - Nunca solicita ni usa la ubicación. Funciona tanto si tu app, o una biblioteca como
react-native-maps, incluyeplay-services-locationcomo si no, incluida la versión 21 y superiores.
1.0.0 no enviaba el fingerprint de ClearSale cuando tu app resolvía play-services-location 21 o posterior. Usa 1.0.1 o posterior; no se requiere ningún cambio en android-sdk.Migrar desde la dependencia heredada com.yuno.fraud-prevention:clearsale
Migrar desde la dependencia heredada com.yuno.fraud-prevention:clearsale
com.yuno.fraud-prevention:clearsale:- Elimina esa dependencia del archivo de compilación de tu app y agrega
yuno-sdk-antifraud-clearsaleen su lugar. - Elimina las llamadas a
onCreateYunoClearSale,onResumeYunoClearSaleyonStopYunoClearSalede los métodos del ciclo de vida de tu Activity. - Deja de pasar el id de sesión de ClearSale como
merchantSessionId. Ahora el Yuno SDK lo recopila y lo envía por ti.
Antifraude de Koin
- Envía a Yuno el fingerprint del dispositivo de Koin como
customer.device_fingerprintdel pago. No cambia nada en los datos que envías. - Declara
INTERNET; se combina con tu manifest automáticamente. - Nunca solicita ni usa la ubicación. El SDK de Koin se inicializa con su función de geolocalización deshabilitada, por lo que el módulo no lee
ACCESS_FINE_LOCATIONniACCESS_COARSE_LOCATIONaunque tu app los tenga.
Antifraude de Riskified
- Inicia el beacon de dispositivo de Riskified siempre que la configuración de tu checkout habilite Riskified, y envía la sesión del beacon a Yuno como
customer.device_fingerprintdel pago, para cualquier método de pago, incluido Google Pay. - Incluye el SDK de Android de Riskified (variante
nogoogle) desde Maven Central: sin dependencia de Google Play services y sin rastreo de ubicación. - Declara
INTERNET; se combina con tu manifest automáticamente. El módulo elimina el permisoREAD_PHONE_STATEdeclarado por el SDK de Riskified, por lo que nunca llega a tu app.
Antifraude de Signifyd
- Ejecuta el perfilado de dispositivo de Signifyd siempre que la configuración de tu checkout habilite Signifyd, y envía el id de sesión de Signifyd a Yuno en
payment_method.device_fingerprintsdel pago, para cualquier método de pago. No cambia nada en los datos que envías. - Necesita el registro privado de Signifyd y tu propio token de Signifyd para descargar el SDK de Signifyd en tiempo de compilación. El registro, la configuración del token, los permisos y los datos que recopila están en Antifraude de Signifyd (Android).
Netcetera 3DS
- Ejecuta el desafío de 3D Secure dentro de tu app, para pagos e inscripción de tarjetas, en lugar del desafío basado en WebView. Si tu app personaliza los estilos del Yuno SDK, estos se propagan a la pantalla del desafío.
- Necesita el repositorio de Maven de Netcetera en tu proyecto y, solo para pruebas en sandbox, un certificado que te entrega tu TAM de Yuno. Ambos pasos están en Netcetera 3DS (Android).
Revolut Pay
- Después de crear el pago y llamar a
continuePayment(), el SDK deriva al comprador a la app de Revolut cuando está instalada, y si no, al flujo web de Revolut, y lo trae de vuelta automáticamente. Es compatible con los flujos Full, Lite, Seamless y Render. - Declara el deeplink de retorno
yunorevolut://<your.application.id>y la visibilidad de paquetes para la app de Revolut; ambos se combinan con tu manifest automáticamente. - Incluye el SDK de Android de Revolut (
com.revolut:revolutpay) desde Maven Central. - En Render, el checkout vive dentro de tu propia Activity: no la finalices al presionar atrás mientras se muestra la pantalla de Revolut, para que el comprador pueda volver y se pueda entregar el estado final.
Solución de problemas
El módulo está instalado, pero el fingerprint o el desafío nativo nunca aparece
El módulo está instalado, pero el fingerprint o el desafío nativo nunca aparece
- El proveedor está habilitado para tu cuenta de Yuno. Los módulos solo se ejecutan cuando el backend solicita ese proveedor para la transacción; consulta a tu TAM de Yuno si no estás seguro.
- El módulo se registró al iniciar: filtra Logcat por
KoinAntifraud,ClearSaleAntifraud,RiskifiedAntifraudoSignifydAntifraudy busca la línearegistered. - Tu app no está eliminando el provider de App Startup del manifest. Si lo está haciendo, ejecuta los inicializadores de los módulos manualmente como se describe en Activar un módulo.
Fallo en tiempo de ejecución con NoSuchMethodError o NoSuchFieldError que menciona com.yuno
Fallo en tiempo de ejecución con NoSuchMethodError o NoSuchFieldError que menciona com.yuno
android-sdk es anterior a la versión que requiere el módulo. Actualízalo al mínimo indicado en Módulos disponibles, o a uno superior.Gradle: could not find com.netcetera.threeds…
Gradle: could not find com.netcetera.threeds…
Logcat: Missing API_KEY param; skipping Signifyd profiling
Logcat: Missing API_KEY param; skipping Signifyd profiling
Logcat: NoClassDefFoundError com.google.android.gms.location.LocationServices (ClearSale)
Logcat: NoClassDefFoundError com.google.android.gms.location.LocationServices (ClearSale)
1.0.0 cuando tu app no incluye play-services-location. Se captura dentro del SDK de ClearSale y el fingerprint se recopila de todos modos. La versión 1.0.1 ya no busca la biblioteca de ubicación: actualiza a ella y el trace desaparece.Los pagos se procesan, pero sin fingerprint de ClearSale
Los pagos se procesan, pero sin fingerprint de ClearSale
1.0.0 y tu app resuelve play-services-location 21 o superior, actualiza a 1.0.1. De lo contrario, el timeout del proveedor configurado en tu cuenta de Yuno es demasiado bajo para la captura de ClearSale (que espera 500 ms antes de generar el id de sesión). Mantenlo en 1 segundo o más; el valor por defecto es 5 segundos.Conflicto de manifest merger en androidx.startup.InitializationProvider
Conflicto de manifest merger en androidx.startup.InitializationProvider
tools:node="merge" en el provider, o ejecuta los inicializadores de los módulos manualmente como se describe en Activar un módulo.