Mercado Pago para agentes de IA: cómo cobrar con Checkout Pro desde un asistente
Mercado Pago lanzó en beta una librería abierta para que un agente de compras con IA genere el pago con Checkout Pro sin que el modelo decida precios ni toque credenciales. Qué es, cómo funciona y qué queda a cargo de tu pyme.
8 min de lectura Investigado y publicado con Claude
En este artículo
Mercado Pago publicó en versión beta una librería de código abierto que permite que un agente de compras con inteligencia artificial genere el link de pago de Checkout Pro de forma segura. Se llama Commerce Agents Checkout, está escrita en Python y, según el anuncio de Mercado Pago Developers, mantiene credenciales, precios y URLs de pago del lado del servidor, fuera del alcance del modelo de IA. Para una pyme argentina que vende online, abre una puerta interesante: que un asistente conversacional no solo responda consultas, sino que también lleve al cliente hasta el pago. Pero no es un producto "enchufar y listo": es una pieza técnica que exige un desarrollo serio alrededor.
Qué anunció Mercado Pago#
A fines de septiembre de 2026, el portal para desarrolladores de Mercado Pago presentó la novedad bajo el título "Implementá pagos en el checkout de tu agente de IA". Los puntos principales del anuncio son:
- Es una librería abierta en Python, en versión 0.1.0 y en beta.
- Implementa una función llamada
checkout_handoff: el momento en que el agente "pasa la posta" al checkout para que el cliente pague. - Se integra con el proyecto abierto de agentes de comercio de Anthropic.
- Usa el SDK oficial de Mercado Pago y su Orders API.
- Está disponible para Argentina, Brasil, México, Uruguay, Colombia, Chile y Perú.
- Mercado Pago menciona además un plugin para Claude Code que analiza proyectos en Python y guía la integración sin modificar el código hasta que el desarrollador lo confirme.
El código está publicado en GitHub con licencia Apache 2.0. El propio repositorio aclara que no está afiliado, respaldado ni mantenido por Anthropic: es un desarrollo de Mercado Pago que se apoya en un estándar abierto.
Qué es el proyecto de agentes de comercio de Anthropic#
La librería se conecta con Claude Commerce Agents, un "plano de referencia" de código abierto que publicó Anthropic para construir agentes de compras. Incluye dos agentes:
- Agente de compras (vidriera): busca y compara productos, arma carritos, responde preguntas sobre políticas de la tienda y recuerda preferencias del cliente.
- Agente del comerciante (back office): explica métricas, mantiene publicaciones, actúa ante alertas de stock y pedidos, y propone precios, promociones y campañas. Todo lo que modifica queda pendiente hasta que una persona lo aprueba.
Un detalle clave: según su documentación, ese proyecto no procesa pagos reales. Su punto de checkout solo muestra el carrito para que otro sistema complete la compra. Ahí entra Mercado Pago: su librería implementa ese paso final para que el carrito termine en una orden de pago real.
Cómo funciona, paso a paso#
Según el README del repositorio, cuando el agente pide pasar al pago, la librería recibe la sesión, el carrito, una referencia externa del vendedor y una clave de idempotencia (un identificador que evita cobrar dos veces lo mismo si algo se reintenta). Después:
- Valida la estructura del carrito, con un máximo de 20 líneas.
- Vuelve a leer cada precio desde el catálogo de confianza del comercio, no desde lo que dijo el modelo.
- Crea una orden con la Orders API de Mercado Pago para Checkout Pro.
- Devuelve el link de pago validado, o nada si algo no cierra.
El principio de seguridad: el modelo nunca decide el precio#
La regla central está escrita tal cual en la documentación: "The model never decides the price" (el modelo nunca decide el precio). El catálogo de confianza es obligatorio y los precios jamás se toman de la IA. Si el precio del catálogo cambió respecto del que el cliente confirmó en el carrito, la librería rechaza la orden y pide una nueva confirmación.
Esto es importante porque los modelos de lenguaje pueden equivocarse o ser manipulados con instrucciones escondidas en un mensaje. Un cliente podría intentar convencer al agente de que "este producto está a mitad de precio". Con este diseño, aunque el agente se confunda, el precio que llega a Mercado Pago sale siempre de tu sistema.
Además, el README indica que los identificadores de recuperación no se registran en los logs, que los casos dudosos (cuando no se sabe si la orden se creó) generan un error explícito en lugar de reintentar a ciegas, y que no se envían datos personales del comprador a Mercado Pago.
Lo que la librería no hace (y queda de tu lado)#
El anuncio es claro: activar checkout_handoff no confirma el pago. El repositorio enumera las responsabilidades del vendedor:
| Responsabilidad | Qué implica para tu pyme |
|---|---|
| Autenticar al comprador | Saber quién es el cliente y que el carrito es suyo |
| Guardar los identificadores de cada intento | Persistir la referencia externa y la clave de idempotencia en una base de datos |
| Configurar webhooks de órdenes | Recibir el aviso real de Mercado Pago cuando el pago se acredita |
| Validar la firma de los webhooks | Confirmar que el aviso viene de Mercado Pago y no de un tercero |
| Conciliar órdenes | Cruzar lo cobrado con lo vendido antes de dar el pago por bueno |
| Despacho y stock | Entregar el producto y descontar inventario |
En otras palabras, la librería resuelve el tramo más delicado (que la IA no toque precios ni credenciales), pero el resto de una integración profesional sigue siendo necesario. Si ya trabajaste con notificaciones de pago por webhooks, el esquema te va a resultar familiar.
¿Le sirve a una pyme argentina?#
Depende de cómo vendas hoy. Algunos escenarios donde tiene sentido evaluarlo:
- Tiendas con catálogo propio y muchas consultas repetidas, donde un asistente puede ayudar a elegir talle, modelo o variante y llevar directo al pago.
- Negocios que ya usan un agente de IA en la web y pierden ventas en el salto entre la conversación y el checkout.
- Empresas con desarrollo propio en Python o dispuestas a sumar un servicio en ese lenguaje junto a su tienda.
Y casos donde conviene esperar:
- Si tu tienda funciona bien con un checkout tradicional y el volumen de consultas no justifica un agente.
- Si no tenés un catálogo con precios confiables y actualizados en un sistema propio: es requisito.
- Si necesitás algo estable para producción crítica: la librería es una versión 0.1.0 en beta, y lo razonable es probarla primero en un entorno de pruebas.
Si tu canal principal es WhatsApp, tené en cuenta que el costo de la conversación también cuenta: lo explicamos en la nota sobre los nuevos precios de WhatsApp Business API.
Qué hacer ahora#
- Definí el objetivo. ¿Querés que el agente responda dudas, arme carritos o cierre ventas? No todos los negocios necesitan las tres cosas.
- Ordená tu catálogo. Precios, stock y variantes tienen que estar en un sistema confiable al que el backend pueda consultar.
- Revisá tu integración actual de Mercado Pago. Si todavía no tenés webhooks configurados y validados, empezá por ahí: es la base de cualquier cobro automatizado.
- Probá en un entorno de pruebas. Instalá la librería en un proyecto separado, con credenciales de prueba, y medí cómo responde el flujo completo.
- Cuidá las credenciales. El Access Token de Mercado Pago tiene que vivir solo en el servidor. Nuestra guía para proteger las claves de API de tu pyme explica cómo guardarlas y rotarlas.
- Pensá en el control humano. Para devoluciones, descuentos especiales o cambios de precio, dejá que una persona apruebe. Es la misma lógica que propone el agente del comerciante de Anthropic.
Si estás comparando plataformas de agentes antes de decidir, te puede servir nuestra comparativa de agentes de IA en 2026.
Preguntas frecuentes#
¿Necesito usar Claude para aprovechar esta librería?#
La librería implementa el contrato de pago del proyecto de agentes de comercio de Anthropic, que está pensado para correr con Claude. El plugin que menciona Mercado Pago es para Claude Code, una herramienta de programación. Si tu agente usa otro modelo, habría que evaluar cómo adaptar la integración.
¿Funciona en Argentina?#
Sí. Según el anuncio de Mercado Pago, está disponible para Argentina, Brasil, México, Uruguay, Colombia, Chile y Perú.
¿El agente puede cobrar solo, sin que el cliente intervenga?#
No. La librería genera un link de Checkout Pro y el cliente completa el pago ahí. El agente no maneja tarjetas ni datos de pago.
¿Tiene costo la librería?#
El código es abierto, con licencia Apache 2.0. Los cobros siguen las condiciones comerciales de tu cuenta de Mercado Pago, y el modelo de IA que use el agente tiene su propio costo.
¿Está lista para producción?#
Es una versión 0.1.0 en beta. Conviene probarla en un entorno de pruebas, seguir sus actualizaciones y sumar las validaciones que el propio repositorio deja a cargo del vendedor.
Llevá tus cobros al siguiente nivel#
En Mark-Co Digital integramos Mercado Pago con Checkout Pro, configuramos webhooks y conciliación, y desarrollamos agentes de IA a medida en Python o TypeScript cuando un asistente estándar no alcanza. Si querés evaluar si un agente de ventas tiene sentido para tu negocio, conocé nuestro servicio de integración de medios de pago o escribinos.
