Connect
API REST

Consultar pagos recibidos en Mercado Pago

Lee los pagos que RECIBIÓ la cuenta de Mercado Pago de esta conexión, YA sincronizados: estado, monto, moneda, lo reembolsado, el neto recibido, las comisiones y cuándo se libera el dinero. Sirve para conciliar ventas y cobros. No es saldo ni cartola: no incluye retiros ni transferencias. Lectura pura: NO contacta a Mercado Pago ni dispara una sincronización. Revisa 'cobertura' antes de concluir que no hay pagos: una lista vacía con 'cobertura.completa' en false no lo prueba. Para traer datos nuevos usa 'mercadopago.conexion.sincronizar'. Pagina con 'cursor'.

POST
/v1/tools/mercadopago.pagos.consultar/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.pagos.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "pagos": [      {        "pagoId": "string",        "estado": "string",        "estadoDetalle": "string",        "fechaCreacion": "string",        "fechaAprobacion": "string",        "fechaActualizacion": "string",        "fechaLiberacion": "string",        "estadoLiberacion": "string",        "moneda": "string",        "monto": "string",        "montoReembolsado": "string",        "montoNetoRecibido": "string",        "comisiones": {          "estado": "declaradas",          "totalReceptor": "string",          "detalle": [            {              "tipo": "string",              "monto": "string",              "pagador": "string"            }          ]        },        "medioPago": "string",        "tipoMedioPago": "string",        "tipoOperacion": "string",        "cuotas": -9007199254740991,        "referenciaExterna": "string",        "descripcion": "string",        "sincronizadoEn": "string"      }    ],    "cobertura": {      "desde": "string",      "hasta": "string",      "completa": true,      "ventanasSinLeer": -9007199254740991,      "sincronizadoEn": "string"    },    "cursor": "string"  },  "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  }}

Verificar conexión Mercado Pago POST

Prueba las credenciales de la conexión contra Mercado Pago haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.

Consultar reembolsos de Mercado Pago POST

Lee los reembolsos YA sincronizados de los pagos que recibió la cuenta de Mercado Pago de esta conexión, con su monto, estado y fecha. Connect sólo los lee: nunca crea ni cancela un reembolso. Lectura pura: NO contacta a Mercado Pago ni dispara una sincronización. Revisa 'cobertura' antes de concluir que no hay pagos: una lista vacía con 'cobertura.completa' en false no lo prueba. Para traer datos nuevos usa 'mercadopago.conexion.sincronizar'. Pagina con 'cursor'.