Connect
API REST

Consultar retiros de Mercado Pago

Lee los retiros de dinero de la cuenta de Mercado Pago de esta conexión (transferencias a cuentas bancarias, sus cancelaciones y retiros en efectivo), YA sincronizados desde los reportes «Dinero en cuenta» que la cuenta tiene. Sirve para conciliar salidas de fondos. Requiere el módulo 'egresos' habilitado en la conexión. Un retiro a una cuenta propia es movimiento de fondos, no un gasto. Lectura pura: NO contacta a Mercado Pago, NO genera reportes y no es saldo ni cartola completa. Revisa 'cobertura' antes de concluir que no hubo retiros. Para traer datos nuevos usa 'mercadopago.conexion.sincronizar' con 'egresos'. Pagina con 'cursor'.

POST
/v1/tools/mercadopago.egresos.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.egresos.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "egresos": [      {        "operacionId": "string",        "tipo": "retiro_bancario",        "tipoMercadoPago": "string",        "moneda": "string",        "monto": "string",        "montoNeto": "string",        "monedaLiquidacion": "string",        "comision": "string",        "fechaOperacion": "string",        "fechaLiquidacion": "string",        "medioPago": "string",        "tipoMedioPago": "string",        "referenciaExterna": "string",        "conflicto": true,        "reporteId": "string",        "reporteCreadoEn": "string",        "sincronizadoEn": "string"      }    ],    "cobertura": {      "busqueda": {        "estado": "nunca",        "realizadaEn": "string",        "reportesListados": -9007199254740991      },      "reportes": {        "procesados": -9007199254740991,        "parciales": -9007199254740991,        "pendientes": -9007199254740991,        "noUsados": -9007199254740991      },      "periodosLeidos": [        {          "desde": "string",          "hasta": "string"        }      ],      "ultimosReportes": [        {          "reporteId": "string",          "periodoDesde": "string",          "periodoHasta": "string",          "creadoEn": "string",          "formato": "string",          "estado": "listado",          "motivo": "string",          "retiros": -9007199254740991        }      ]    },    "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 pagos recibidos en Mercado Pago POST

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'.