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.
Flujo de pago
El SDK ofrece una experiencia de pago unificada: los clientes completan transacciones con varios métodos de pago en una sola integración. El siguiente diagrama ilustra el flujo de pago principal.SolicitudRespuestaÉxito
Pasos del flujo de pago
- Servidor del comercio:
Create Customer→ Servidor de Yuno:Creates Customer - Cliente del comercio:
Initiate Checkout→ Servidor del comercio:Create Checkout session - Servidor del comercio:
Create Checkout session→ Servidor de Yuno:Creates Checkout session - Cliente del comercio:
Initiate Checkout→Initiate SDKto continue payment flow - Cliente del comercio:
Initiate SDKto continue payment flow → Yuno SDK:Receive checkout session - Yuno SDK:
Receive checkout session→List payment methods - Yuno SDK:
List payment methods→ El usuario selecciona los métodos de pago - Yuno SDK: El usuario selecciona los métodos de pago → Callback con el
one-time token - Yuno SDK: Callback con el
one-time token→ Cliente del comercio: Recibe elone-time token(de un solo uso) - Cliente del comercio: Recibe el
one-time token(de un solo uso) →Initiate payment - Cliente del comercio:
Initiate payment→Initiate SDKto continue payment flow - Cliente del comercio:
Initiate SDKto continue payment flow → Yuno SDK:Continue with the payment flow - Yuno SDK:
Continue with the payment flow→ Muestra una pantalla para que el usuario complete el pago - Yuno SDK: Muestra una pantalla para que el usuario complete el pago → Muestra el
payment result(opcional) - Cliente del comercio:
Initiate payment→ Servidor del comercio:Create payment - Servidor del comercio:
Create payment→ Servidor de Yuno:Creates paymenten el proveedor de pago
Flujo de pago con un token almacenado
Si un cliente tiene un método de pago inscrito, puede usar un token almacenado (vaulted token) para pagar sin volver a ingresar los datos de pago.SolicitudRespuestaÉxito
Pasos del flujo con token almacenado
- Cliente del comercio:
Initiate checkout→ Servidor del comercio:Create Customer - Servidor del comercio:
Create Customer→ Servidor de Yuno:Create Customer - Cliente del comercio:
Initiate SDKcon lacheckout session→ Yuno SDK:Receive checkout session - Yuno SDK:
Receive checkout session→List payment methods - Yuno SDK:
List payment methods→ El usuario selecciona los métodos de pago - Yuno SDK: El usuario selecciona el método de pago → Callback con el
one-time token - Yuno SDK: Callback con el
one-time token→ Cliente del comercio:Initiate payment - Cliente del comercio:
Initiate payment→ Servidor del comercio:Create payment - Servidor del comercio:
Create payment→ Servidor de Yuno:Creates paymenten el proveedor de pago - Cliente del comercio: Muestra el
payment result→ Servidor del comercio:Receive payment result - Servidor del comercio:
Receive payment result→ Servidor de Yuno: Proporciona elpayment result
Flujo de inscripción
La inscripción es el proceso de guardar un método de pago (por ejemplo, una tarjeta) en la cuenta de un cliente para poder usarlo más adelante (por ejemplo, con un token almacenado). full-checkout admite la inscripción; el siguiente diagrama describe el flujo de inscripción.SolicitudRespuestaÉxito
Pasos del flujo de inscripción
- Servidor del comercio:
Create Customer→ Servidor de Yuno:Creates Customer - Cliente del comercio:
Add payment method→ Servidor del comercio:Create customer session - Servidor del comercio:
Create customer session→ Servidor de Yuno:Creates customer session - Cliente del comercio:
Display payment methods to enroll→ Servidor del comercio:Request available payment methods to enroll - Servidor del comercio:
Request available payment methods to enroll→ Servidor de Yuno:Returns available payment method - Cliente del comercio:
Display payment methods to enroll→ Cliente del comercio: El usuario selecciona el método de pago que desea inscribir - Cliente del comercio: El usuario selecciona el método de pago que desea inscribir → Cliente del comercio:
Initiate enrollment - Cliente del comercio:
Initiate enrollment→ Cliente del comercio:Initiate SDKto continue enrollment - Cliente del comercio:
Initiate SDKto continue enrollment → Yuno SDK:Continue enrollment flow - Yuno SDK:
Continue enrollment flow→ Yuno SDK: Muestra pantallas para que el usuario complete la inscripción - Servidor del comercio: Recibe el
enrollment resultmediante webhook → Servidor de Yuno: Recibe losenrollment resultsdel proveedor de pago - Servidor de Yuno: Recibe los
enrollment resultsdel proveedor de pago → Yuno SDK: Muestra elenrollment result(opcional)
Flujo del Headless SDK
El Headless SDK ofrece máxima flexibilidad al permitirte gestionar toda la interfaz de usuario, mientras Yuno se encarga de la lógica de pago compleja y de la seguridad (como 3DS).SolicitudRespuestaÉxito
Pasos del flujo headless
- Servidor del comercio:
Create Customer→ Servidor de Yuno:Creates Customer - Cliente del comercio:
Initiate Checkout→ Servidor del comercio:Create Checkout session - Cliente del comercio:
Collect Information→ El usuario ingresa los datos de la tarjeta o del método de pago en tu interfaz personalizada. - Cliente del comercio:
Generate Token→ Yuno SDK: Llama agenerateToken(details)para recibir unone-time token. - Cliente del comercio:
Process Payment→ Servidor del comercio: Envía elone-time tokena tu backend. - Servidor del comercio:
Create Payment→ Servidor de Yuno: Llama a la API Create Payment. - Cliente del comercio:
Handle Actions→ Si la respuesta de la API devuelvesdk_action_required: true, usa el SDK para gestionar 3DS u otras acciones de pago.