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.
Orientación: elige tu flujo de integración. Antes de comenzar, revisa el flujo de integración oficial.
  • Flujo estándar (Full Checkout): Recomendado para la mayoría de los comercios. Yuno se encarga de la interfaz, la seguridad y las actualizaciones automáticas de los métodos de pago.
  • Flujo personalizado (este SDK): Úsalo solo si necesitas control total sobre la experiencia de usuario. Nota: Serás responsable de gestionar manualmente los estados de los pagos, las transiciones de 3DS y la recopilación de datos para el enrutamiento de fraude.
Sigue esta guía paso a paso para implementar y habilitar la capacidad de inscripción del Lite SDK de iOS de Yuno en tu app.

Paso 1: incluye la biblioteca en tu proyecto

Antes de continuar con la implementación del Lite SDK, consulta la Guía de inicio rápido para ver las instrucciones detalladas sobre cómo integrar correctamente el SDK en tu proyecto. Es compatible con CocoaPods y Swift Package Manager. Elige el método de integración que mejor se adapte a tu flujo de desarrollo y a tus requisitos técnicos. Después de completar la integración del SDK, puedes continuar con los siguientes pasos para implementar la capacidad de inscripción del Lite SDK.

Paso 2: inicializa el SDK

Inicializa el Yuno SDK en tu AppDelegate (o en la estructura App para SwiftUI) proporcionando una PUBLIC_API_KEY válida:
CredencialesConsulta la página de credenciales para obtener más información: /reference/getting-started/authentication

Paso 3: crea una sesión de cliente

Para iniciar el proceso de inscripción, debes proporcionar el customer_session. Primero, debes crear un cliente. Usa el endpoint Create Customer para crear nuevos clientes. En la respuesta, recibirás el id del cliente, que usas para crear la sesión de cliente. Después de crear el cliente, puedes crear la sesión de cliente. Usa el id del cliente y el endpoint Create Customer Session. El customer_session se proporcionará en la respuesta. Necesitas un nuevo customer_session cada vez que inscribas un nuevo método de pago.

Paso 4: adopta YunoEnrollmentDelegate

Para gestionar el proceso de inscripción, tu clase (normalmente un UIViewController) debe adoptar el protocolo YunoEnrollmentDelegate.
Requisitos de concurrencia de Swift 6Si usas Swift 6, deberás implementar el protocolo YunoEnrollmentDelegate teniendo en cuenta consideraciones específicas de concurrencia. Consulta la guía Swift 6 Concurrency para ver las opciones de implementación detalladas y las mejores prácticas.

Propiedades del delegate

Paso 5: inicia el flujo de inscripción

Una vez que hayas implementado el delegate, llama a enrollPayment para iniciar la interfaz de inscripción:

Parámetros

App de demostraciónAdemás de los ejemplos de código proporcionados, puedes acceder al repositorio del SDK de Yuno para iOS para ver una implementación completa de los Yuno SDK.

Gestión de errores

Gestiona en tu app los errores que devuelve el SDK, como errores de inscripción fallida o de validación. Para conocer los códigos de estado HTTP y de respuesta, consulta Códigos de estado y de respuesta en la referencia de la API.

Mantente al día

Visita las notas de la versión para ver las últimas actualizaciones del SDK y el historial de versiones.