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.
Recursos adicionales
- Consulta Elige la integración adecuada para ti si no estás seguro de qué flujo seguir.
- Accede a las notas de la versión o al repositorio del Yuno iOS SDK para verificar la última versión disponible del SDK.
- Inscripción con full-checkout (iOS): inscripción automática con componentes de interfaz prediseñados
Requisitos
- CocoaPods o Swift Package Manager
- iOS 14.0 o posterior
- Cuenta activa de Yuno; credenciales de API (obtenlas en el Dashboard de Yuno → Developers > Credentials)
- Crea un cliente con el endpoint Crear cliente antes de realizar la inscripción
Parámetros
Para ver la lista completa de parámetros, consulta la Referencia común del SDK de iOS.Inscripción con full-checkout (iOS)
El Yuno full-checkout SDK para iOS ofrece inscripción con interfaz prediseñada, inscripción de tarjetas, manejo de estados y manejo básico de errores. Consulta la sección anterior de Requisitos.Paso 1: crea un cliente y una sesión de cliente
Crea un cliente en el sistema de Yuno con el endpoint Crear cliente antes de inscribir métodos de pago. Este endpoint devolverá uncustomer_id que usarás para asociar los métodos de pago inscritos con el cliente específico.
Luego crea una sesión de cliente con el endpoint Crear sesión de cliente. La información de la sesión se usará al llamar a los métodos de inscripción.
customer_session que usarás en el siguiente paso.
En tu servidor, crea también un objeto de método de pago para inscripción para esa sesión de cliente, a fin de definir qué método de pago puede inscribir el cliente. Mantén tus claves de API privadas en el servidor.
Paso 2: incluye la biblioteca en tu proyecto
Incluir la biblioteca en tu proyecto se hace de la misma manera que en los flujos de pago. Sigue allí los pasos de Incluye la biblioteca en tu proyecto.CocoaPods
Swift Package Manager
Paso 3: inicializa el SDK con la clave pública
Inicializa el SDK:- Obtén tu clave de API pública en el Dashboard de Yuno
- Inicializa el SDK llamando a
Yuno.initialize()con tu clave de API:
YunoConfig para personalizar el comportamiento del SDK. Incluye esta configuración al llamar a Yuno.initialize(). Por ejemplo:
Paso 4: implementa el delegate de inscripción
Crea una clase que adopte el protocoloYunoEnrollmentDelegate:
Requisitos de concurrencia de Swift 6Si usas Swift 6, deberás implementar el protocolo
YunoEnrollmentDelegate con consideraciones específicas de concurrencia. Consulta la guía de concurrencia de Swift 6 para ver opciones de implementación detalladas y mejores prácticas.Opciones
Paso 5: inicia el proceso de inscripción
Llama al métodoenrollPayment() para mostrar el flujo de inscripción:
UIViewController a pantalla completa usando el viewController proporcionado en tu delegate. En SwiftUI, envuelve un UIViewController y devuélvelo mediante la propiedad viewController.
Opciones
En SwiftUI, envuelve un
UIViewController y devuélvelo desde la propiedad viewController para que el SDK pueda presentar la interfaz.
Paso 6: maneja el regreso del deep link (opcional)
Solo es necesario cuando el flujo de inscripción usa deep links. Si tu método de pago no usa deep links, omite este paso. De lo contrario, maneja el regreso en tuAppDelegate:
url.scheme coincida con el callback_url usado al crear el customer_session.
Paso 7: maneja el resultado de la inscripción
El SDK llama a tu método delegateyunoEnrollmentResult(_:) con el estado final:
Estados del resultado de la inscripción
Yuno.Result no incluye tokens. Además del status de alto nivel, expone substatus y message (SDK 2.27.0 y posteriores).