Saltar al contenido
ESENIr al Portal

Novedades del widget

Qué trae cada versión del SDK y del checkout: nuevo, cambios, correcciones y si tenés que actualizar.

Lo que cambia en el SDK @chytapay/integration-widget y en el checkout, versión por versión. Los cambios de la API están en Novedades de la API.

Cada entrada dice de qué parte es:

  • SDK: corre en tu página. Lo servís vos, desde npm o desde el CDN, así que un cambio te llega cuando subís de versión.
  • Widget: es el checkout que mostramos en el iframe, y lo hospedamos nosotros. Un cambio ahí lo tenés la próxima vez que un pagador abre el checkout, sin que hagas nada.

Cada una cierra con lo que tenés que hacer. Cómo integrarlo está en Widget de checkout.

1.7.0 · 3 de noviembre de 2026

Nuevo · SDK y Widget · Apariencia por integración. Si configuraste la apariencia en el Portal, el checkout la usa desde el primer cuadro: tu color, tu logo y el color del encabezado. El SDK la lee antes de abrir el checkout. Si esa lectura falla o tarda más de un segundo, el checkout se abre con la marca de Chytapay y el pago sigue igual. Ver Apariencia desde el Portal. Requiere actualizar el SDK. Sin apariencia configurada, se ve igual que antes.

Nuevo · SDK y Widget · Animación de carga a elección. Con la marca de Chytapay, la apariencia puede elegir entre el spinner y la chita. Con tu logo, el spinner usa tu color. Requiere actualizar el SDK. Sin esa elección, se ve igual que antes.

Nuevo · Widget · En computadoras, la pantalla del CVU ofrece Pagá desde tu celular: un QR para pagar con Mercado Pago desde el celular, en el checkout ancho y en el angosto. En celulares y tablets no se ofrece: ahí está el botón de Mercado Pago. ¿Tenés que hacer algo? No.

Nuevo · SDK · checkout({ layout }): "compact" deja el checkout angosto (420 px) también en computadoras, y "desktop" usa el ancho. Para ese cobro, pisa el ancho que elegiste en el Portal. ¿Tenés que hacer algo? No.

Cambio · SDK y Widget · En computadoras, el checkout aprovecha el ancho: ocupa hasta 720 px (antes 420), en el modal y en tu contenedor, y pone los datos del pagador y la cuenta que recibe lado a lado. En celulares y tablets se ve igual que antes. Con un SDK anterior el checkout sigue en 420 px. ¿Tenés que hacer algo? Solo si tu columna asume 420 px: limitá el ancho del contenedor, o usá layout: "compact".

Corrección · SDK · En páginas con color-scheme: dark, el modal mostraba esquinas y bordes blancos. Ahora el fondo del iframe es transparente. Requiere actualizar.

Corrección · SDK · En computadoras, el checkout aparece directo en su tamaño final, sin un salto de alto al abrir, y el indicador de carga tiene el mismo tamaño que el del checkout. Requiere actualizar.

1.6.1 · 28 de octubre de 2026

Corrección · SDK · Si la Content Security Policy de tu página bloquea el frame con el que abrimos Mercado Pago en Android o en Chrome de iPhone, el SDK navega tu página al link en vez de dejar un botón que no hace nada. Una política en modo Report-Only no bloquea el frame y no mueve la página. Requiere actualizar. Para que tu página no se mueva, sumá mercadopago: e intent: a frame-src. Ver CSP.

Corrección · SDK · En el celular, si tu página desborda a lo ancho, el checkout se estiraba con ella: quedaba más ancho que la pantalla y cortado a la derecha. Ahora toma el ancho y la posición del área visible, y se recalcula al abrir, al hacer scroll y al cambiar el tamaño. Requiere actualizar. No hace falta tocar tu página.

Nuevo · Widget · En el navegador interno de TikTok, Instagram y Facebook, donde Mercado Pago a veces no abre la app, el widget le pide al pagador abrir la página en su navegador y deja el CVU para copiar. ¿Tenés que hacer algo? No.

1.6.0 · 26 de octubre de 2026

Cambio · SDK · Al detectar el pago, onSuccess se llama al instante, pero el checkout queda unos 2,5 s en pantalla con "¡Recibimos tu transferencia!". Cerrarlo después de un pago ya no dispara onCancel. ¿Tenés que hacer algo? No. Si en onSuccess redirigís o mostrás tu propia pantalla, funciona igual.

Cambio · Widget · "Ya transferí" consulta el pago y se queda en los datos para transferir. Si todavía no lo vemos, le pide al pagador revisar la cuenta desde la que transfirió y le ofrece cambiar el documento. Si no pudimos consultar, le pide reintentar. ¿Tenés que hacer algo? No. Con un SDK anterior a la 1.6.0, el aviso llega a los 5 s.

Nuevo · Widget · Si el checkout no recibe el pago en 15 s, deja el indicador de carga y muestra "No pudimos cargar el pago" con un botón Reintentar. ¿Tenés que hacer algo? No.

Cambio · SDK · El title del iframe pasó de ChytaPay checkout a Pago con ChytaPay, para lectores de pantalla. ¿Tenés que hacer algo? Solo si un test tuyo busca el iframe por el title viejo.

Deprecación · SDK · checkoutLink(), init({ linkToken }) y getLinkPayment() son de uso interno de Chytapay y no tienen soporte: pueden cambiar o desaparecer sin una versión mayor. ¿Tenés que hacer algo? Solo si los usabas: pasate a init({ pk }) y checkout().

1.5.0 · 15 de octubre de 2026

Incluye las 1.3.0 y 1.4.0, que no se publicaron por separado.

Cambio · SDK · init({ pk }) elige la API y el iframe según el prefijo de la clave: una pk_test_ va a Sandbox y una pk_live_ a Producción. Antes una pk_test_ sin opciones le pegaba a Producción y fallaba. Si pasás apiBaseUrl o iframeUrl, cada uno sigue pisando al derivado. Un prefijo desconocido cae a Producción y deja un aviso en la consola. ¿Tenés que hacer algo? No. Si pasabas las URLs de Sandbox a mano, ya podés sacarlas.

Cambio · SDK · ChytaPayConfig y WidgetPayerInput dejaron de ser interface. Requiere acción solo en TypeScript, si extendías esos tipos o armabas el objeto con campos de más: pasá solo pk en la config y solo taxDocument en el pagador. En JavaScript no cambia nada.

Nuevo · SDK y Widget · Aviso opcional de DNI de menor: si el pagador escribe un DNI que por su número parece de un menor, el widget le recuerda que va el del titular de la cuenta desde la que transfiere. No bloquea. Nace apagado. ¿Tenés que hacer algo? Solo si lo querés: pedinos activarlo. Requiere el SDK 1.5.0 o posterior.

Cambio · Widget · La pantalla del documento dice "DNI del titular de la cuenta" y explica que va el de la cuenta desde la que se transfiere. El selector DNI o CUIT se reemplazó por el link "Pago desde una cuenta de empresa". ¿Tenés que hacer algo? No.

Cambio · Widget · La pantalla del CVU dice de qué cuenta tiene que salir la transferencia, y el CVU se ve completo en celulares angostos. ¿Tenés que hacer algo? No.

Cambio · Widget · Mensajes propios para cobro vencido, cancelado, plazo de la pantalla agotado y pago parcial vencido, con qué hacer en cada caso. Dejan de ofrecer copiar el CVU o abrir la billetera cuando ya no corresponde. ¿Tenés que hacer algo? No.

Corrección · Widget · El resumen del pagador muestra el DNI en lugar del CUIL de 11 dígitos de una persona física. ¿Tenés que hacer algo? No.