Saltar al contenido principal
Esta página documenta un SDK heredado. ¿Vas a iniciar una nueva integración? Usa el Yuno SDK. ¿Ya usas un SDK heredado? Sigue la guía de migración.El nuevo Yuno SDK (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) reemplaza los SDK Full, Lite, Seamless, Render, Headless y Secure Fields con una sola API en todas las plataformas. Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejarlos de usar en 2027. Contacta a tu Account Manager para planificar la migración.
El Yuno iOS SDK se mantiene pequeño a propósito: cada SDK nativo de terceros se entrega como un módulo independiente y opcional. Agregas solo los módulos que necesita tu integración, y el Yuno SDK los detecta automáticamente cuando un checkout usa el proveedor correspondiente. Tu código de pago e inscripción no cambia.
Instalar un módulo no hace que el SDK lo use: un módulo se ejecuta solo cuando el proveedor está habilitado para tu cuenta de Yuno y el backend lo solicita para la transacción actual.

Módulos disponibles

Nombres de los paquetes según el método de instalación: Todos los módulos requieren YunoSDK 2.25.0 o superior, excepto Riskified, que requiere YunoSDK 2.29.0 o superior, y Signifyd, que requiere YunoSDK 2.30.0 o superior mediante Swift Package Manager. Netcetera tiene pasos de configuración adicionales (certificado de sandbox), que se explican en Netcetera 3DS (iOS). Signifyd se entrega en su propio paquete y necesita un token de Signifyd, como se explica en Signifyd antifraud (iOS).

Instalación

Cada módulo vive en el mismo paquete que el Yuno SDK, así que solo hay una URL que agregar. En Xcode ve a File > Add Package Dependencies… y agrega:
elige la regla Up to Next Major Version a partir de 2.25.0 (2.29.0 si agregas Riskified) y, en la lista de productos, marca YunoSDK más los módulos que necesites (YunoAntifraudClearsale, YunoAntifraudKoin, YunoAntifraudRiskified, Yuno3DSNetcetera). No se requiere nada más: cada producto incluye su propio binario del proveedor.
Signifyd no está en este paquete: se entrega en yuno-sdk-ios-signifyd y necesita tu token de Signifyd para descargar el SDK de Signifyd. Consulta Signifyd antifraud (iOS).

Activación de un módulo

La forma en que un módulo se registra en el Yuno SDK depende de cómo lo instalaste.
Los módulos instalados mediante Swift Package Manager son frameworks dinámicos y se registran solos cuando se inicia la aplicación. No se requiere código adicional más allá de agregar el producto a tu target.
Una vez que un módulo está registrado, el Yuno SDK lo usa automáticamente. No necesitas cambiar ningún código de pago, inscripción ni 3DS.

Solución de problemas

Los frameworks estáticos no se registran solos. Asegúrate de llamar a register() del módulo antes de Yuno.initialize(...).
La línea platform de tu Podfile está por debajo del mínimo del módulo. Usa platform :ios, '14.0' para los módulos de antifraude y 3DS, o '15.0' si agregas YunoRevolutPay.
Un pod de módulo depende de YunoSDK ~> 2.25 (~> 2.29 para YunoAntifraudRiskified). Si tu Podfile fija un SDK más antiguo (por ejemplo '2.24.1'), amplíalo al rango del módulo.
YunoRevolutPay requiere RevolutPayments/RevolutPay ~> 3.16.0. Si tu Podfile fija otra versión de RevolutPayments, alinéala a '~> 3.16.0' o quita la fijación y deja que YunoRevolutPay la incluya.
Agrega el hook post_install que se muestra en la pestaña de CocoaPods anterior para que todos los targets de pods compilen para iOS 15.0.
El producto YunoAntifraudRiskified ya incluye RiskifiedBeacon 1.6.4 de Riskified. Si tu aplicación también agrega el paquete propio de Riskified, quítalo y conserva solo el producto de Yuno.
El deeplink de regreso no está llegando al Yuno SDK. Asegúrate de que tu aplicación declare un esquema de URL, de que las URL entrantes se reenvíen a Yuno.receiveDeeplink(url) y de que un guard sobre el esquema no esté descartando la URL de regreso de Revolut Pay (yourscheme://revolut-pay).
Afecta solo a YunoAntifraudClearsale 1.0.0. El módulo se registra solo, así que no necesitas importarlo desde Swift: quita la línea import YunoAntifraudClearsale y el proyecto compila.