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.
Registra el callback opcional onInstallmentSelected para mantener el total de tu carrito sincronizado con el plan de cuotas que el comprador elige en el formulario de tarjeta. El SDK te notifica cuando se preselecciona una cuota predeterminada y cada vez que el comprador cambia la selección. También te notifica cuando el plan se recalcula (por ejemplo, después de un cambio de BIN). El callback es opcional en todas las plataformas: si no lo registras, el comportamiento del SDK no cambia. Las excepciones lanzadas dentro de tu callback son capturadas por el SDK y nunca interrumpen el flujo de pago.

Implementación

Proporciona tus propias opciones de cuotas con onGetInstallments

Disponible desde el SDK Web 1.6.7. Pasa onGetInstallments dentro de las opciones de card; el SDK lo llama cuando conoce el BIN de la tarjeta y muestra en el selector de cuotas lo que devuelvas. El callback tiene un tiempo de espera de 10 segundos; si se agota el tiempo, lanza un error o devuelve un arreglo vacío, undefined o nada, el SDK recurre a los planes de cuotas configurados en Yuno.
El callback recibe un único argumento de tipo objeto y puede ser asíncrono:
El SDK vuelve a llamar a onGetInstallments cada vez que cambia el BIN o el monto, e ignora una respuesta obsoleta si ya comenzó una llamada más reciente. Las opciones que devuelves se reportan a onInstallmentSelected con isMerchantInstallment: true.

Reacciona a la elección del comprador con onInstallmentSelected

Pasa el callback dentro de las opciones de card de startCheckout:
El callback recibe un único argumento de tipo objeto, o null cuando la selección anterior ya no es válida:
Cuando la opción seleccionada proviene de tu callback onGetInstallments (isMerchantInstallment: true), installmentId, type, rate y financialCosts son undefined, y el token de un solo uso se crea con installment: null.Semántica de ejecución:
  • Se ejecuta con la selección actual en cuanto se muestra el plan y se preselecciona una cuota predeterminada, de modo que tu total sea correcto desde el primer renderizado.
  • Se ejecuta en cada selección que hace el comprador.
  • Vuelve a ejecutarse con la selección actual cuando cambian las opciones disponibles (por ejemplo, un cambio de BIN recalcula el plan).
  • Se ejecuta con null cuando las opciones notificadas anteriormente dejan de estar disponibles, por ejemplo cuando el comprador cambia a una tarjeta sin cuotas (desde el SDK 1.10.3). Solo se ejecuta si antes se notificó una selección, por lo que los formularios que nunca tuvieron cuotas permanecen en silencio.
  • Funciona en todos los flujos de tarjeta, incluidos los campos seguros y Click to Pay.