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 SDK de iOS facilita la implementación de flujos de inscripción para guardar métodos de pago en la cuenta de un cliente. Incluye la biblioteca en tu proyecto siguiendo los mismos pasos que en full-checkout.

Recursos adicionales

Requisitos

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á un customer_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.
La respuesta incluye un ID de 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

Ejecuta:

Swift Package Manager

Consulta las notas de la versión o el repositorio del Yuno iOS SDK para ver la versión actual del SDK.

Paso 3: inicializa el SDK con la clave pública

Inicializa el SDK:
  1. Obtén tu clave de API pública en el Dashboard de Yuno
  2. Inicializa el SDK llamando a Yuno.initialize() con tu clave de API:
Usa la data class 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 protocolo YunoEnrollmentDelegate:
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étodo enrollPayment() para mostrar el flujo de inscripción:
El SDK presenta de forma modal un 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. 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 tu AppDelegate:
Asegúrate de que 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 delegate yunoEnrollmentResult(_:) 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).

Funciones complementarias

Para estilos, temas, opciones de formulario y configuraciones adicionales, consulta Personalizaciones del SDK.

Referencia común

Para ver los detalles completos de parámetros y personalización, consulta la Referencia común del SDK de iOS.