Pagos

Mercado Pago — Saldo

SELLERP refleja el saldo real de tu cuenta Mercado Pago (disponible + retenido) en tiempo casi real. Reconciliación con la API de movimientos para garantizar consistencia.

Qué expone

  • Saldo disponible — fondos liquidados que puedes retirar.
  • Saldo retenido — fondos en período de seguridad (release calendar).
  • Próximos releases — calendario de cuándo se liberan los retenidos.
  • Movimientos aprobados — feed de transacciones (ingresos + egresos) con filtro approved.

Cómo se calcula

Usamos la "difference formula": empezamos con el último snapshot conocido y aplicamos los movimientos aprobados desde entonces. Esto evita el problema de timezone que tendría una re-consulta directa. La consulta a MP corre cada 3 minutos por organización.

MCP tool

El MCP expone balance_snapshot que devuelve el shape:

  • balance_available (MXN, decimal)
  • balance_held
  • last_snapshot_at (ISO 8601)

En API REST, el saldo aún no está expuesto en v1 — es uno de los siguientes endpoints en el roadmap. Mientras tanto, el MCP es el camino oficial para leerlo programáticamente.