Connect
API REST

Sincronizar Mercado Pago con estado de autorización de reportes

Sincroniza pagos y, si pides egresos, retiros de «Todas las transacciones». Prefiere esta versión a mercadopago.conexion.sincronizar. El resultado ejecutado distingue omitted por falta de autorización de los parciales operativos. Revisa gestionReportes para la autorización, la capacidad, la acción humana y la ruta al panel, también al encolar. Consulta mercadopago.egresos.consultar_v2 para el resultado guardado. Una lista vacía no demuestra cero retiros. No mueve dinero ni otorga consentimiento.

POST
/v1/tools/mercadopago.conexion.sincronizar_v2/execute

Authorization

AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/mercadopago.conexion.sincronizar_v2/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "periodo": "string",    "estado": "encolado",    "jobId": "string",    "yaEnCurso": true,    "results": [      {        "alcance": "pagos",        "marcador": "string",        "status": "ok",        "recordsSynced": -9007199254740991,        "error": "string",        "detalle": "string",        "motivo": "falta_autorizar"      }    ],    "gestionReportes": {      "autorizacion": "sin_autorizar",      "capacidadHabilitada": true,      "motivo": "falta_autorizar",      "accionHumana": "autorizar_reportes",      "ruta": "string",      "avance": {        "historico": {          "leidas": 0,          "total": 0,          "periodosLeidos": [            {              "desde": "string",              "hasta": "string"            }          ]        },        "diario": {          "fecha": "string",          "estado": "pedido"        }      }    }  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Sincronizar conexión Mercado Pago POST

Compatibilidad v1: prefiere mercadopago.conexion.sincronizar_v2 para distinguir la autorización de reportes. Sincroniza los pagos que RECIBIÓ la cuenta de Mercado Pago de esta conexión, con sus reembolsos y comisiones, y los guarda para consultarlos con 'mercadopago.pagos.consultar' y 'mercadopago.reembolsos.consultar'. Es el ÚNICO camino que trae datos de Mercado Pago. Trae lo actualizado desde la última vez y completa hacia atrás el historial que Mercado Pago permite buscar (12 meses), por tramos: con mucho volumen, varias sincronizaciones seguidas completan el historial y el resultado lo dice en 'detalle'. Con el módulo 'egresos' habilitado en la conexión y pedido en 'alcances', además lee los retiros de los reportes «Todas las transacciones» que la cuenta ya tiene para 'mercadopago.egresos.consultar'. La configuración y generación de reportes se gestionan por separado, con autorización previa en Ajustes. Nunca cobra, reembolsa, transfiere ni mueve dinero. No trae saldo. Un 'upstream_error' o un resultado 'partial' por límite de consultas es transitorio y no invalida la autorización.

Verificar conexión Mercado Pago POST

Comprueba que la autorización de Mercado Pago siga vigente. Hace una consulta real a su API con la autorización guardada; no hay clave ni login. No sincroniza ni devuelve datos. Si ya no vale, responde connection_credential_required (428): la persona la renueva en el panel de Connect, en Ajustes de la conexión → Volver a autorizar, con la MISMA cuenta de Mercado Pago. Este sistema no se reconecta con conexiones.enlace.crear.