API de Mercado Pago: qué se puede hacer y cómo usarla con agentes de IA
La API de Mercado Pago, en su versión para Brasil, permite crear cobros, consultar pagos, emitir reembolsos, gestionar suscripciones y recibir notificaciones de cambio de estado. La usan tiendas en línea, empresas SaaS y negocios que venden por enlace, Pix (el sistema de pagos instantáneos de Brasil) o checkout propio. El acceso se hace con las credenciales de la cuenta del propio vendedor, generadas en el panel de desarrollador. Fuera de Brasil, la plataforma se conoce como Mercado Pago en cada país, con su propia documentación.
Qué ofrece la API de Mercado Pago
Pagos
Creación y consulta de pagos con tarjeta, Pix y boleto (el comprobante de pago bancario brasileño), con el estado de cada transacción.
Preferencias y checkout
Generación de enlaces y preferencias de pago para Checkout Pro y para integraciones de checkout propio.
Reembolsos y cancelaciones
Devolución total o parcial de un pago aprobado y cancelación de cobros pendientes.
Suscripciones
Planes y cobros recurrentes para quien vende por cuota mensual.
Notificaciones (webhooks)
Avisos automáticos cuando un pago cambia de estado, como aprobado, rechazado o revertido.
Clientes y tarjetas
Registro de compradores y tarjetas guardadas para facilitar compras futuras.
Cómo acceder a la API de Mercado Pago
- Con las credenciales de tu empresaLa integración usa un access token de la cuenta (con un par de credenciales de prueba y de producción) generado en el panel de desarrollador. Para operar en nombre de otros vendedores, hay un flujo OAuth con una aplicación registrada.
- Separa las credenciales de prueba y de producción, y nunca uses las de producción en pruebas.
- Los reembolsos mueven dinero: deja esa acción con aprobación humana y un tope por monto.
- Los datos de los compradores son personales (en Brasil, los protege la LGPD, su ley de protección de datos): limita lo que el agente lee y registra.
Documentación oficial: www.mercadopago.com.br/developers
Qué hace un agente de iTeam con la API de Mercado Pago
Conciliación de los cobros del día
El agente de finanzas cruza los pagos aprobados en Mercado Pago con los pedidos del ERP y señala diferencias de monto, comisión o pedidos sin pago.
Reembolso con aprobación
El agente de atención prepara la devolución de un pedido retornado, muestra monto y motivo, y solo la ejecuta cuando el responsable aprueba por WhatsApp o Teams.
Cobro de pago pendiente
Cuando un Pix o un boleto no se paga a tiempo, el agente genera un enlace nuevo y lo envía al cliente, registrando cada intento.
Alerta de contracargo y rechazo
El agente sigue las notificaciones de estado y avisa al equipo cuando sube la tasa de rechazo o aparece una disputa.
De la credencial al agente trabajando, con aprobación
Generar las credenciales
En el panel de desarrollador de Mercado Pago, crea una aplicación y copia las credenciales de prueba y de producción de la cuenta de la empresa.
Guardar en la bóveda de iTeam
Registra el token en la bóveda de iTeam y define qué puede hacer cada agente: consultar pagos, generar enlaces o pedir reembolsos.
Probar con aprobación humana
Empieza con las credenciales de prueba y mantén los reembolsos y los cobros bajo aprobación hasta que el proceso esté validado.
Equipos de IA listos que usan Mercado Pago
Preguntas sobre la API de Mercado Pago
¿La API de Mercado Pago es gratuita?
El uso de la API en sí no suele tener un cobro aparte. Lo que se paga son las comisiones sobre cada transacción, según el medio de pago y el plan de la cuenta.
¿Necesito programar para usar la API de Mercado Pago con iTeam?
No necesariamente. La herramienta HTTP de iTeam lee la documentación oficial y el equipo de implementación configura las llamadas. Tú solo aportas la credencial y las reglas de aprobación.
¿El agente puede crear un enlace de pago por sí solo?
Puede, si le das ese permiso. Lo más habitual es permitir la generación de enlaces y dejar las devoluciones y cancelaciones con aprobación.
