Estado de la conexión

Informa si tu cuenta tiene Mercado Pago conectado. Sirve para diagnosticar un skipped al pedir un link de cobro: sin esto, no tenés forma de verificar por API si el problema es la conexión.

Endpoint

GET /api/cobros/estado

Funciona con cualquier scope de key.

Request

curl https://arca.api.com.ar/api/cobros/estado \
  -H "Authorization: Bearer ak_TuSecretoAqui"

No lleva body ni parámetros. No lleva representada ni environment: la conexión es de la cuenta, no de un CUIT emisor.

Cuenta conectada

Status: 200

{
  "available": true,
  "connected": true,
  "connection": {
    "mpUserId": "123456789",
    "environment": "produccion",
    "connectedAt": "2026-07-01T13:20:45.000Z"
  }
}

Campo	Tipo	Descripción
`available`	`boolean`	Si la integración con Mercado Pago está habilitada. En `false` no hay nada que conectar
`connected`	`boolean`	Si tu cuenta autorizó a arca.api
`connection.mpUserId`	`string`	Identificador de tu cuenta en Mercado Pago. Sirve para confirmar cuál conectaste
`connection.environment`	`"homologacion"` \| `"produccion"`	Entorno de la cuenta conectada. Ver debajo
`connection.connectedAt`	`string`	Cuándo se autorizó (ISO 8601, UTC)

La respuesta nunca incluye tokens, secretos ni ningún material de la conexión: sólo estos metadatos.

Cuenta sin conectar

Status: 200

{
  "available": true,
  "connected": false,
  "connection": null
}

Con connected: false, ningún comprobante va a generar link: todos devuelven skipped con "La cuenta no tiene Mercado Pago conectado".

Cómo resolverlo: entrá a la sección Cobros del dashboard y autorizá la conexión. No se puede hacer por API: el OAuth requiere que una persona autorice en Mercado Pago.

Comparar el entorno

connection.environment viene en la misma nomenclatura que el environment de tus comprobantes, para que puedas compararlos directamente:

comprobante.environment === connection.environment  →  se puede generar el link
comprobante.environment !== connection.environment  →  skipped por entornos cruzados

Es el segundo motivo más frecuente de skipped y el más difícil de diagnosticar a ciegas — de ahí que este endpoint lo informe. Ver Los entornos tienen que coincidir.

Errores

Status	Descripción
`401`	API key ausente, inválida o revocada

No consume cuota del plan.