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.
El Headless iOS SDK de Yuno te permite inscribir métodos de pago y tokenizar tarjetas para guardarlas y usarlas en el futuro. Los siguientes pasos describen cómo inscribir un método de pago con el Headless SDK de Yuno.

Requisitos

Para ejecutar el proceso de inscripción, debes proporcionar el customer_session para iniciarlo en el Paso 3. Para obtener el customer_session, debes:
  1. Crear un cliente: se requiere un cliente para inscribir pagos. Usa el endpoint Create Customer para crear nuevos clientes. En la respuesta recibirás el id del cliente, que usarás para crear la sesión de cliente.
  2. Crear la sesión de cliente: usa el id del cliente y el endpoint Create Customer Session para recibir el customer_session.

Paso 1: incluye la biblioteca en tu proyecto

El primer paso es instalar el Yuno SDK en tu proyecto iOS.
Consulta las versiones del iOS SDKPara ver todas las versiones disponibles, visita la página de versiones en el repositorio del Yuno iOS SDK.
Puedes instalar el Yuno SDK de dos maneras:
  • Cocoapods: si no tienes un Podfile, sigue la guía de CocoaPods para crear uno. Después de crear el Podfile, integrarás el Yuno SDK con Cocoapods agregando la siguiente línea a tu Podfile:
  • Swift Package Manager: configura el paquete de Swift y luego agrega el Yuno SDK como dependencia, como se muestra en el siguiente bloque de código:

Paso 2: inicializa el Headless SDK con la clave pública

Para inicializar el Headless SDK, debes importar Yuno y proporcionar una PUBLIC_API_KEY válida. Si no tienes tus credenciales de API, accede a la página Developers (Credentials) para ver cómo obtenerlas desde el Dashboard. El siguiente bloque de código presenta un ejemplo de cómo importar e inicializar Yuno.
Requisitos de concurrencia de Swift 6Si usas Swift 6, deberás manejar correctamente la concurrencia al usar los métodos asíncronos del SDK. Consulta la guía Swift 6 Concurrency para ver opciones de implementación detalladas y mejores prácticas.
Inicialización con UISceneDelegateSi tu aplicación usa un UISceneDelegate, puedes inicializar Yuno dentro de tu SceneDelegate. Sin embargo, si prefieres inicializar Yuno en otra parte de tu aplicación, también puedes hacerlo. El método de inicialización ofrece un callback que te notifica cuando el proceso ha terminado.

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. Necesitas un cliente con el que inscribir pagos. Usa el endpoint Create Customer para crear nuevos clientes. En la respuesta recibirás el id del cliente, que usarás 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 entregará en la respuesta. Necesitas un nuevo customer_session cada vez que inscribas un nuevo método de pago.

Paso 4: crea un objeto de método de pago de inscripción

Necesitas un objeto de método de pago de inscripción para configurar la integración del Headless SDK para la inscripción. Puedes crearlo con el endpoint Enroll Payment Method. Al crear el objeto de método de pago, debes definir en qué método de pago puede inscribirse tu cliente. Actualmente, solo CARD está disponible para el Headless SDK.
Verificación de tarjetaPara verificar las tarjetas con una autorización de valor cero antes de la inscripción, incluye el objeto verify al crear el objeto de método de pago para la sesión de cliente.

Paso 5: inicia el proceso de inscripción

A continuación, iniciarás el proceso de checkout con la función apiClientEnroll, proporcionando los parámetros de configuración necesarios.
Manejo de erroresEste método lanza un error si el Yuno SDK no se ha inicializado antes de llamarlo.

Parámetros

La siguiente tabla enumera todos los parámetros requeridos y sus descripciones. El siguiente bloque de código presenta un ejemplo de la configuración de los parámetros.

Paso 6: genera un vaulted token

Después de recopilar toda la información del usuario, puedes iniciar la inscripción. Primero, debes crear un vaulted_token con la función apiClientEnroll.continueEnrollment. Como es una función asíncrona, puedes usar do/catch para asegurarte de manejar correctamente los errores que se produzcan. A continuación, encontrarás un ejemplo de cómo crear un vaulted_token:
Después de inscribir la nueva tarjeta, recibirás el vaulted_token. Puedes usarlo para realizar pagos en el futuro sin pedir los datos de la tarjeta de tu cliente. El siguiente bloque de código presenta un ejemplo de respuesta de la función apiClientEnroll.continueEnrollment. La respuesta es un diccionario de tipo [String: String] con claves en camelCase: vaultedToken, status y customerSession.
Uso de webhooks para el estado de la inscripciónConsidera usar el estado de la inscripción recibido mediante webhooks. Yuno recomienda basar siempre las decisiones de negocio de tu plataforma en este estado.
Accede a la aplicación de demostraciónAdemás de los ejemplos de código proporcionados, puedes acceder al repositorio de Yuno para ver una implementación completa de los iOS SDK de Yuno.

Manejo de errores

Maneja en tu aplicación los errores devueltos por el SDK, como pagos fallidos o errores de validación. Para los códigos de estado HTTP y de respuesta, consulta Códigos de estado y de respuesta en la referencia de la API.