Finanzas y pagos
Mercado Pago en tu producto y en tus agentes de IA, con una API
El toolkit de Mercado Pago cubre pagos, preferencias de pago (enlaces de Checkout Pro), planes de suscripción y suscripciones: buscar y leer pagos, cancelar uno pendiente, crear enlaces de checkout, crear planes y pausar, reactivar o cancelar suscripciones. El vendedor conecta con su propio access token, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/mercado_pago_create_preference/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"items": []
}
}Cómo funciona
Del cliente conectado a la primera llamada a Mercado Pago.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Mercado Pago. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Mercado Pago.
Enlaces de checkout desde tu producto
Crea una preferencia de pago con ítems y precios y envía el enlace init_point al comprador, que paga con Pix, tarjeta, boleto o saldo de Mercado Pago.
Conciliación de pagos
Busca los pagos recibidos y lee status, status_detail y el monto neto recibido, para conciliar los pedidos en tu plataforma.
Gestión de suscripciones
Crea planes de suscripción y pausa, reactiva o cancela la suscripción de un comprador desde tu propia pantalla de cobro.
Tools
12 tools de Mercado Pago
- Buscar pagosGETBusca los pagos que recibió la cuenta en los últimos 12 meses; sin fechas, los creados en los últimos 3 meses. La respuesta tiene results y paging con total, limit y offset: aumenta offset en limit para leer la página siguiente.
- Obtener pagoGETDevuelve un pago: status y status_detail, transaction_amount, transaction_details con el monto neto recibido, medio y tipo de pago, cuotas, pagador y fechas.
- Actualizar pagoPUTCancela un pago aún pending, in_process o authorized, como un boleto o Pix sin pagar, o cambia la fecha de vencimiento de uno pendiente. Un pago aprobado no se cancela aquí: se reembolsa en Mercado Pago.
- Buscar preferenciasGETLista las preferencias de pago, los enlaces de checkout, creadas en los últimos 90 días. La respuesta tiene elements, next_offset y total. El enlace en sí, init_point, viene de Obtener preferencia.
- Obtener preferenciaGETDevuelve una preferencia de pago con sus ítems, pagador, configuración de pago, vigencia e init_point, el enlace de checkout que se envía al comprador. Funciona para preferencias de cualquier antigüedad.
- Crear preferenciaPOSTCrea una preferencia de pago y la devuelve con id e init_point, el enlace de Checkout Pro donde el comprador paga con Pix, tarjeta, boleto o saldo de Mercado Pago. Cada ítem necesita id, title, quantity y unit_price. Comparte init_point con el comprador.
- Actualizar preferenciaPUTCambia los campos enviados de una preferencia de pago, como ítems, precios, datos del comprador o vigencia. El id y el enlace init_point siguen siendo los mismos.
- Buscar planes de suscripciónGETBusca los planes de suscripción de la cuenta. Cada plan en results tiene id, reason, auto_recurring, status, subscribed (cuántos suscriptores) e init_point, el enlace donde un comprador se suscribe. Pagina con offset y limit; paging trae el total.
- Crear plan de suscripciónPOSTCrea un plan de suscripción y lo devuelve con id e init_point, el enlace donde los compradores se suscriben con tarjeta. Requiere reason, back_url y auto_recurring con frequency, frequency_type y currency_id.
- Actualizar plan de suscripciónPUTCambia los campos enviados de un plan de suscripción, como el nombre, el monto o el ciclo. El id y el enlace init_point siguen siendo los mismos.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Mercado Pago
¿Necesito implementar la API de Mercado Pago?
No. Connect ya trae 12 tools de Mercado Pago descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Mercado Pago?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.

Conta Azul