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.
Te damos la bienvenida a la guía de inicio rápido de los SDK de Yuno. Esta guía te muestra cómo implementar fácilmente el flujo de pago completo de Yuno, su solución más sencilla, con una interfaz prediseñada y la visualización automática de los métodos de pago. Elige tu plataforma y sigue los pasos para empezar a procesar tus primeros pagos con Yuno.

1. Instala

Para iniciar la descarga del SDK mientras carga la página, agrega un preload y preconnects al <head> de tu HTML. Consulta Precarga el script del SDK.O inclúyelo mediante CDN:

2. Inicializa y procesa el pago

3. Agrega el contenedor HTML y el botón de pago

Consulta Tarjetas de prueba más abajo.Para ver una descripción completa de todos los parámetros del Web SDK, consulta Referencia común del Web SDK.Guía completa de Web →Equivalente en el nuevo SDK: Migración al modo Full en Web.

Manejo de un pago fallido

Equivalente en el nuevo SDK: el controlador onStatus. El Web SDK puede recuperarse de un pago fallido sin recargar la página. Dos mecanismos funcionan en conjunto:
  • Reintento de pago: reintento de tarjeta en línea cuando el pago devuelve DECLINED o ERROR. En Seamless, el SDK gestiona el reintento automáticamente. En Full Checkout, Lite y Secure Fields, llamas a continuePayment después de que tu backend confirme el rechazo. Funciona con tarjetas de crédito y débito no inscritas. Consulta Reintento de pago para ver la referencia completa.
  • Cambio de método de pago: llama a updateCheckoutSession(newSession) para inyectar una nueva sesión de checkout sin desmontar el SDK. Elegir de la lista de métodos de pago ya renderizada funciona después de cambiar la sesión; un conjunto diferente de métodos de pago requiere desmontar y volver a montar el SDK, no recargar la página. Consulta updateCheckoutSession.
En un intento reintentado, el SDK no dispara paymentResult. Entrega la sesión de checkout clonada a tu callback onLoading como { type: 'PAYMENT_RETRY', data: { newCheckoutSession } }. Registra onLoading en tu configuración de startCheckout para recibirla:

Integración del backend

Tu backend debe implementar dos endpoints de API para funcionar con Yuno. El nuevo SDK usa la misma sesión de checkout: consulta Crear la sesión de checkout.

  1. Crear la sesión de checkout

Antes de mostrar la interfaz de pago, tu backend crea una sesión de checkout:
  • Endpoint: POST https://api-sandbox.y.uno/v1/checkout/sessions
  • Obligatorios (OpenAPI): account_id, merchant_order_id, payment_description, country
  • Envía también: customer_id (de Create Customer) y amount { currency, value }
  • Opcionales para el SDK: workflow (SDK_CHECKOUT | SDK_SEAMLESS | CHECKOUT), callback_url, checkout_id
  • Devuelve: el ID de checkout_session (se usa en el SDK)
  • Referencia: API Crear sesión de checkout
Ejemplo de solicitud:

  1. Crear el pago

En el callback del token de un solo uso (OTT), tu backend crea el pago:
  • Endpoint: POST https://api-sandbox.y.uno/v1/payments
  • Encabezado obligatorio: X-Idempotency-Key (UUID único por intento), consulta Autenticación
  • Cuerpo obligatorio (OpenAPI): account_id, description, country, merchant_order_id, amount, payment_method, checkout
  • payment_method.token = token de un solo uso del callback del SDK
  • checkout.session = ID de la sesión de checkout del paso 1
  • Devuelve: el estado del pago y el campo sdk_action_required
  • Referencia: API Crear pago
Ejemplo de encabezados:
Ejemplo de solicitud:
Importante: Si la respuesta de la API tiene sdk_action_required: true o checkout.sdk_action_required: true, debes llamar al método continuePayment() del SDK para completar los métodos de pago asíncronos (autenticación 3DS, PIX, redirecciones bancarias, etc.).

Parámetros

Parámetros principales que se usan en este inicio rápido: Referencia completa de parámetros: Flujos de pago (Web), Flujos de pago (iOS), Flujos de pago (Android).

Métodos de integración alternativos

Si necesitas más control sobre la interfaz de usuario o sobre flujos de pago específicos, Yuno ofrece métodos de integración alternativos:

Lite SDK

Una integración ligera que te da control total sobre la visualización de los métodos de pago, mientras Yuno se encarga del procesamiento seguro del pago.

Secure Fields

Crea tus propios formularios de pago desde cero con los componentes de interfaz de Yuno para lograr la máxima personalización (solo Web).

Tarjetas de prueba

El nuevo SDK tiene su propia lista: consulta Tarjetas de prueba.