Consultar el estado del cobro

Informa el estado de cobro de un comprobante. Es el camino soportado para enterarte de un pago: arca.api no emite webhooks salientes.

Endpoint

POST /api/wsfe/comprobante/cobro/estado

Funciona con cualquier scope de key, incluido read_only: consultar si te pagaron no modifica nada. Ver Scopes de API key.

Request

curl -X POST https://arca.api.com.ar/api/wsfe/comprobante/cobro/estado \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "produccion",
    "representada": "27111111118",
    "cbteTipo": 6,
    "ptoVta": 1,
    "cbteNro": 42
  }'

Parámetros

Cobro pendiente

Status: 200

{
  "found": true,
  "paymentStatus": "pending",
  "initPoint": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=123456789-abcd-...",
  "amount": 24200,
  "mpPaymentId": null,
  "paidAt": null,
  "createdAt": "2026-07-18T10:00:00.000Z"
}

Cobro pagado

Status: 200

{
  "found": true,
  "paymentStatus": "paid",
  "initPoint": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=123456789-abcd-...",
  "amount": 24200,
  "mpPaymentId": "1234567890",
  "paidAt": "2026-07-20T14:03:11.000Z",
  "createdAt": "2026-07-18T10:00:00.000Z"
}

Comprobante sin link de cobro

Status: 200

{ "found": false }

No es un error: el comprobante existe, simplemente nunca se le generó link. Puede ser porque la cuenta no tenía Mercado Pago conectado al emitir, porque la moneda no es cobrable, o porque todavía no lo pediste. Generalo si corresponde.

Si el comprobante no existe, en cambio, la respuesta es 404.

Verificación activa

Por defecto la consulta sólo lee el estado guardado: es barata y apta para consultar seguido.

Con verificar: true le preguntamos a Mercado Pago por el pago de ese comprobante y, si está aprobado, lo marcamos como pagado en el momento —la misma transición que aplicaría la notificación automática, y idempotente: repetirla sobre un cobro ya pagado no cambia nada ni altera los datos del pago.

curl -X POST https://arca.api.com.ar/api/wsfe/comprobante/cobro/estado \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "produccion",
    "representada": "27111111118",
    "cbteTipo": 6,
    "ptoVta": 1,
    "cbteNro": 42,
    "verificar": true
  }'

La respuesta es la misma ya actualizada, más un campo verificacion que dice qué pasó al preguntar:

{
  "found": true,
  "paymentStatus": "paid",
  "initPoint": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=123456789-abcd-...",
  "amount": 24200,
  "mpPaymentId": "1234567890",
  "paidAt": "2026-07-20T14:03:11.000Z",
  "createdAt": "2026-07-18T10:00:00.000Z",
  "verificacion": { "status": "paid", "invoiceId": "…" }
}

El campo verificacion sólo aparece cuando mandás verificar: true.

Patrón recomendado para detectar un pago

Como no hay webhooks salientes, detectar un pago es consultar. La forma sensata:

1. Consultá espaciado, sin verificar. La consulta simple sólo lee la base y es barata; en el caso normal la notificación de Mercado Pago ya actualizó el estado y la vas a ver acá. Un intervalo de minutos alcanza — un pago no es un evento de milisegundos.
2. Usá verificar: true antes de tomar una decisión, no en cada vuelta del ciclo. Cada verificación es una llamada a Mercado Pago. Los momentos que lo justifican: antes de dar por impago a un cliente, antes de mandar un recordatorio, antes de cortar un servicio, o cuando el pago viene demorado más de lo razonable.
3. Distinguí "pending" de "failed" en verificacion, como dice el aviso de arriba.
4. Dejá de consultar cuando paymentStatus sea "paid". Un cobro pagado no vuelve atrás.

Conciliación automática por webhook

Cuando alguien paga, Mercado Pago nos notifica y actualizamos el cobro solos. Ése es el camino rápido, y en el caso normal el estado ya está actualizado cuando consultás.

Validamos la firma de cada notificación antes de tocar nada, y la transición a pagado es idempotente: la misma notificación repetida no marca dos veces.

Errores

No hay 403 por scope: este endpoint funciona con keys de solo lectura. No consume cuota del plan.