https://sdk-web.y.uno/v1.11/main.js).Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejar de darles soporte en 2027. Yuno recomienda migrar al nuevo Yuno SDK en lugar de permanecer en un SDK heredado. Consulta la guía de migración. Contacta a tu Account Manager para planificar la migración.Disponibilidad
Fast Payments está disponible en:- Lista de métodos de pago del Yuno SDK 2.0 (
getPaymentMethodsViews), con la sesión de checkout creada conworkflow: 'SDK_SEAMLESS' start()headless del Yuno SDK en Web, desde la versión 2.7.1, cuando tu página ejecuta el SDK de Mercado Pago y construye por sí misma la experiencia del comprador. Consulta Integración headless.- Full checkout del Web SDK v1.11 (
mountCheckout) - Lite checkout del Web SDK v1.11 (
mountCheckoutLite) conpaymentMethodType: 'MERCADO_PAGO_SUPERTOKEN', compatible con los modos de renderizadoelementymodal(Mercado Pago recomiendaelement).
Compatibilidad y plataformas compatibles
Fast Payments funciona en contextos web y requiere que el comprador se autentique con Mercado Pago.Limitaciones funcionales
Antes de planificar tu integración, revisa los límites funcionales en los que Fast Payments no debe usarse:- Recurrencia y transacciones iniciadas por el comercio (MIT): Fast Payments requiere autenticación interactiva del comprador. No se puede usar para el cobro recurrente de suscripciones, el almacenamiento de tarjetas tokenizadas para cargos futuros fuera de sesión ni los flujos MIT.
- Cupones y promociones de Mercado Pago: Los descuentos dentro de la app de Mercado Pago o los códigos de cupón del comercio gestionados dentro de Mercado Pago no se pueden aplicar a través de Fast Payments.
- Captura parcial o montos distintos: No se admite autorizar un monto y capturar después un monto distinto o parcial. El monto capturado debe ser igual al monto de checkout autorizado.
- Campos de subadquirente: Los parámetros personalizados de subadquirente o los indicadores de procesamiento intermediario no se envían a Mercado Pago.
- Pagos divididos: Los pagos divididos 1:1 no son compatibles. Los escenarios de pago dividido 1:N están actualmente en validación y no están disponibles para el lanzamiento general.
Incorporación y requisitos previos
Activar Mercado Pago Fast Payments requiere una configuración coordinada entre el comercio, Yuno y Mercado Pago:- Habilita Fast Payments (Mercado Pago y comercio, en Mercado Pago Developers). Solicita la activación de Fast Payments en tu aplicación de Mercado Pago a través de tu account manager de Mercado Pago.
- Autoriza la conexión (comercio, en el Yuno Dashboard). En Settings > Connections, ejecuta Connect with Mercado Pago para generar los tokens de acceso del vendedor.
- Configura las claves públicas (comercio, en el Yuno Dashboard). Agrega la clave pública de cada sitio de Mercado Pago en el que vendes, etiquetada con su país. Agrega una clave etiquetada
GLOBALcomo respaldo. - Configura el webhook (comercio, en Mercado Pago Developers). Establece la Notification URL en
https://prod.y.uno/mercadopago-webhook/v1/orders/eventsy suscríbete al evento Order (Mercado Pago). - Habilita las reglas de enrutamiento (Yuno y comercio, en el Yuno Dashboard). Habilita el método de pago
MERCADO_PAGO_SUPERTOKENen tu workflow de enrutamiento del checkout.

Configuración de la conexión de Mercado Pago Fast Payments en el Yuno Dashboard
Cómo funciona para el comprador
Full checkout
En el Full checkout, Mercado Pago siempre aparece como una sección en la parte superior de la lista de métodos de pago, encabezada por el logotipo de Mercado Pago. Nunca es una fila seleccionable por sí sola: el comprador selecciona uno de los métodos dentro de la sección. La sección se adapta a lo que Yuno sabe del comprador:
Mercado Pago Fast Payments mostrando los métodos de pago guardados del comprador
https://www.mercadopago.com.ar/privacidad para Argentina). Tus otros métodos de pago aparecen a continuación, bajo un encabezado Other payment methods.
Lite checkout
En el Lite checkout, el SDK renderiza el componente de Mercado Pago en el contenedor configurado parapaymentMethodType: 'MERCADO_PAGO_SUPERTOKEN'. Los compradores seleccionan y se autentican con sus métodos guardados de Mercado Pago directamente dentro de ese componente montado (o modal).
Igual que en el Full checkout, el componente muestra el aviso de privacidad que enlaza a la política de privacidad de Mercado Pago del país del comprador.
Como tu propia página es la dueña de la lista de métodos de pago en el Lite checkout, Yuno no puede quitar de ella la entrada de Mercado Pago. Cuando Mercado Pago no se puede usar, o el comprador no es elegible, el componente montado muestra el mensaje “Mercado Pago is not available right now. Please choose another payment method.”
Integración
Correspondencia de workflow
Estableceworkflow en la sesión de checkout (POST /v1/checkout/sessions) según el SDK que integres:
Ejemplos de integración
- Yuno SDK 2.0 (Recomendado)
- Web SDK v1.11 (Heredado)
Lite checkout con varios métodos de pago
En el Lite checkout, tu página es la dueña de la lista de métodos de pago y el SDK renderiza un método a la vez. Para ofrecer Fast Payments junto con tarjetas y otros métodos, monta el método que selecciona el comprador y mantén un solo botón Pay en tu página. Cuatro reglas definen la integración:- Un solo método montado a la vez.
mountCheckoutLiterenderiza el formulario del método elegido enrenderMode.elementSelector.apmForm(modo element) o en un modal. Si lo llamas de nuevo con otropaymentMethodType, reemplaza el formulario anterior, por lo que los datos escritos y el estado de validación nunca pasan de un método al siguiente. - Tu botón Pay. Con
showPayButton: false, los formularios de tarjeta y de otros métodos no muestran un botón propio.onChangete indica cuándo el formulario montado está completo, yyuno.submitOneTimeTokenForm()lo envía. - Mercado Pago confirma dentro de su propio componente. El componente de Fast Payments conserva sus botones Continue y Pay, y
showPayButtonysubmitOneTimeTokenForm()no se aplican a él. En modo element, oculta tu botón Pay mientras Mercado Pago esté seleccionado. - Un método que no pide nada paga al montarse. Cuando un método no muestra ningún formulario, el SDK crea el token de un solo uso y llama a
createPaymenten cuanto el método se monta. Monta esos métodos cuando el comprador presione Pay, no cuando seleccione el método.
- Modo de renderizado element
- Modo de renderizado modal
#payment-form en cuanto se monta: los métodos guardados cuando el comprador es elegible, o el mensaje de no disponibilidad descrito en Lite checkout cuando Mercado Pago no se puede usar. En ese caso, el comprador selecciona otro método de tu lista y el siguiente montaje reemplaza el mensaje.Integración headless
En una integración headless, tu página ejecuta el SDK de Mercado Pago, muestra los métodos guardados del comprador en tu propia interfaz y obtiene la autorización del comprador. Luego le entregas a Yuno el token autorizado y el método que eligió el comprador contransaction.start(). El Yuno SDK no renderiza nada y crea el mismo token de un solo uso que la lista de métodos de pago.
Fast Payments headless está disponible en el Yuno SDK para Web desde la versión 2.7.1. La integración headless del Web SDK v1 no envía los campos de Mercado Pago.
1. Crea una sesión de checkout para el pago. Créala desde tu backend con workflow: 'SDK_SEAMLESS'. Crea una sesión nueva para cada pago: una vez creado un pago en una sesión, Yuno rechaza otro pago en ella.
2. Carga los métodos de Mercado Pago del comprador. Carga el SDK de Mercado Pago e inicialízalo con la clave pública de la misma aplicación de Mercado Pago que conectaste a Yuno, para el país del checkout. Pasa el monto de la sesión de checkout y el correo electrónico de la cuenta de Mercado Pago del comprador:
wallet() devuelve available: false y ningún método. Cuando el método que elige el comprador tiene securityCode.required, monta el campo de código de seguridad de Mercado Pago con wallet.mountSecurityCode(containerId, { token: method.token }) antes de enviar.
3. Obtén la autorización del comprador. Envía el método elegido. El comprador confirma con Mercado Pago, y el resultado incluye el token autorizado:
wallet, el SDK no crea ningún token y onStatus recibe INTERNAL_ERROR con message.code WALLET_DATA_MISSING. message.reason indica los campos que faltan.
Ambos modos funcionan. Sin createPayment, el SDK crea el pago. Con createPayment, lo creas desde tu backend con el token de un solo uso, como con cualquier otro método.
Token de un solo uso y creación del pago
Cuando el comprador confirma, en la lista de métodos de pago o mediante unstart() headless, el token de un solo uso del SDK lleva por ti los detalles de Mercado Pago:
third_party_tokenes el token que Mercado Pago emite para el método que eligió el comprador. Yuno lo usa para cobrar el pago; tú nunca ves los datos de la tarjeta.provider_method_idyprovider_method_typeidentifican el método dentro de la cuenta de Mercado Pago del comprador (una marca de tarjeta comomaster, oaccount_moneypara el saldo de la cuenta).installmentse envía para tarjetas, con el número de cuotas que el comprador eligió entre las opciones de Mercado Pago. Se omite paraaccount_money.
Idempotencia, reintentos y diagnóstico
- Idempotencia y tiempos de espera del servidor: Incluye siempre un encabezado
X-Idempotency-Keyal crear pagos mediantePOST /v1/payments. Si ocurre un tiempo de espera de red durante esta solicitud, tu servidor debe primero reintentar la solicitud con exactamente el mismoX-Idempotency-Keyo conciliar el estado del pago medianteGET /v1/payments/{payment_id}. - Recuperación del estado del checkout (
continuePayment): Llama ayuno.continuePayment()en el cliente solo después de crear el pago, cuando la respuesta del pago indique que se necesita una acción (comosdk_action_required) o cuando una tarjeta devuelvaDECLINEDoERRORy el comprador deba seleccionar otro método o reintentar. No usescontinuePayment()como sustituto de los reintentos por tiempo de espera del servidor ni de la conciliación de estados. - Diagnóstico para soporte: Al escalar problemas de pagos o de integración al soporte de Yuno o de Mercado Pago, captura y proporciona siempre estos identificadores:
checkout_session: El identificador único de la sesión creada mediantePOST /v1/checkout/sessions.payment_id: El identificador de la transacción devuelto por Yuno en la respuesta del pago.trace_id/request_id: El encabezado de seguimiento de la respuesta HTTP (X-Trace-Id) de las solicitudes a la API.
Países
Fast Payments está disponible en Argentina, Brasil, México y Chile. Sigue tu conexión de Mercado Pago: el SDK usa la clave pública etiquetada con el país del checkout, recurre a una clave etiquetadaGLOBAL y, si no hay ninguna de las dos, usa la primera clave pública de la conexión.
Pruebas y lanzamiento a producción
Lista de verificación de pruebas
Antes de salir en vivo, valida tu integración en los entornos sandbox de Mercado Pago:- Creación de usuarios de prueba: Crea cuentas de prueba de comprador y de vendedor en el portal de Mercado Pago Developers para el sitio del país de destino.
- Configuración de métodos de pago: Asegúrate de que el usuario comprador de prueba tenga métodos de pago guardados en su cuenta de Mercado Pago (tarjeta de crédito y saldo de la cuenta).
- Correo electrónico de la sesión: En
POST /v1/checkout/sessions, pasa el email registrado del comprador de prueba encustomer_payer.email. - Flujo de autenticación: Verifica que las tarjetas guardadas se carguen en la sección del checkout. Prueba las solicitudes del código de seguridad y los pasos de desafío simulados.
- Reglas de enrutamiento: Asegúrate de que las reglas de enrutamiento dirijan las transacciones
MERCADO_PAGO_SUPERTOKENa la conexión de prueba de Mercado Pago.
Lista de verificación del lanzamiento a producción
Al pasar de sandbox a producción:- Autorización OAuth de producción: En el Yuno Dashboard, haz clic en Connect with Mercado Pago en tu cuenta de producción para generar tokens de vendedor activos.
- Claves públicas de producción: Asegúrate de que las claves públicas de producción estén asignadas a cada sitio de país activo.
- Verificación del webhook: Verifica que la Notification URL de producción esté configurada y reciba eventos en Mercado Pago Developers.
- Validación del checkout: Verifica la experiencia de los compradores no elegibles y de los compradores sin métodos de pago guardados, como se describe en Cómo funciona para el comprador.