Consulta ingresos de Polar en Mac: pedidos, MRR y productos

Cuándo resulta útil un panel de Polar en el Mac

Si mantienes varios productos, una consulta rápida de ingresos puede obligarte a buscar el dashboard adecuado y volver a configurar sus filtros. MakerNotch permite asociar una conexión de Polar a un proyecto con nombre, junto a su código y sus despliegues. Selecciona el proyecto, abre Polar, consulta las métricas y continúa trabajando.

Esta guía trata de Polar en polar.sh, la plataforma de pagos. No de Polar Analytics. MakerNotch muestra en el escritorio las métricas que devuelve Polar; utiliza el dashboard de Polar para pedidos individuales, reembolsos, transferencias y gestión de clientes.

Conecta Polar con un token de solo lectura

Necesitas MakerNotch activado, acceso a una organización de Polar y permiso para crear un token de acceso de organización. Si aún no tienes la app preparada, empieza por instalación y activación.

1. En el dashboard de Polar, selecciona la organización que recibe tus ventas. Abre Settings → Developers y crea un token de acceso de organización. Polar explica el proceso en su guía de tokens.
2. Concede únicamente el permiso metrics:read. La conexión de métricas de MakerNotch no necesita crear pedidos, emitir reembolsos ni administrar clientes.
3. Selecciona el proyecto en MakerNotch. Abre Ajustes → Integraciones → Polar y pega el token en el campo de acceso de organización.
4. Deja vacío el UUID opcional del producto para consultar toda la organización o introduce el UUID de un producto de Polar para limitar la vista.
5. Ejecuta la verificación y guarda la conexión. La app guarda el token en el Llavero de macOS y solicita las métricas directamente a Polar.
6. Abre la pestaña Polar. Comprueba el alcance, el intervalo de fechas y la hora de actualización antes de interpretar las cifras.

Un token de organización empieza por polar_oat_. La clave de licencia de MakerNotch es otra credencial y no sirve para esta conexión. El campo de producto acepta un UUID, no un nombre ni un enlace de checkout. Obtén el identificador del producto en Polar; no lo sustituyas por el de un cliente o una organización.

Elige toda la organización o un producto concreto

Imagina que tu organización vende Atlas y Beacon, dos productos de ejemplo. Si dejas vacío el campo de producto en ambos proyectos de MakerNotch, las dos conexiones mostrarán las mismas métricas de toda la organización. Cambiar el nombre de un proyecto en MakerNotch no filtra los datos de Polar.

Para separar las vistas, configura Atlas con su UUID de producto y Beacon con el suyo. Después cambia de proyecto en MakerNotch para consultar cada contexto. Si otro producto pertenece a una organización de Polar diferente, usa el token de esa organización en su conexión.

La conexión actual admite un único UUID opcional de producto. No agrupa una lista personalizada de productos ni calcula un total consolidado entre organizaciones.

Interpreta las métricas sin confundir ingresos y saldo

MakerNotch solicita una ventana de 30 días en UTC, incluida la fecha actual, y muestra las métricas de Polar en USD. El gráfico diario representa la serie de ingresos recibida. Las cifras de hoy todavía pueden cambiar.

Métrica de MakerNotch	Cómo interpretarla
Ingresos y pedidos	Totales devueltos por Polar para el alcance y periodo mostrados
Ingresos netos	La métrica neta devuelta por Polar; no el saldo disponible para retirar
MRR	Ingresos recurrentes mensuales al final del periodo, no todos los ingresos cobrados en esos 30 días
Suscripciones activas	La métrica de suscripciones al final del periodo
Un guion	Esa métrica no fue devuelta; no equivale a cero

La captura contiene datos de ejemplo, no resultados de ventas de MakerNotch. Para conciliar cifras, revisa los pedidos y los informes financieros en Polar. La moneda del checkout, el inicio de tu día local o un filtro de producto diferente pueden explicar comparaciones engañosas. Iguala primero alcance, fechas y moneda.

La integración utiliza el endpoint de métricas de Polar, que proporciona métricas de pedidos y suscripciones con el permiso metrics:read.

Mantén el panel actualizado

Activa las actualizaciones automáticas en los ajustes de MakerNotch para realizar consultas periódicas. Desde la versión 1.1.1, las integraciones conectadas, incluida Polar, participan en la actualización automática del proyecto seleccionado. En condiciones normales, la app programa comprobaciones aproximadamente cada minuto con el panel abierto y cada cinco minutos con él cerrado.

Son comprobaciones periódicas, no una transmisión instantánea de ventas. El reposo, la falta de conexión, los errores de autorización y los límites del proveedor pueden retrasarlas. Los demás proyectos no se vigilan todos continuamente en segundo plano. Usa Actualizar para consultar manualmente y comprueba la hora de actualización para conocer la antigüedad de los datos.

Resuelve una conexión o un total inesperado

• El token se rechaza: comprueba que sea un token de organización, tenga metrics:read, pertenezca a la organización correcta y no esté revocado. No añadas permisos de escritura para arreglar una conexión de lectura.
• Dos proyectos muestran los mismos ingresos: revisa el UUID opcional. Vacío significa toda la organización, aunque los nombres en MakerNotch sean diferentes.
• Falla el filtro de producto: comprueba que el UUID corresponda a un producto de la organización del token.
• Las cifras no coinciden con el dashboard de Polar: compara producto, fechas, límites del día en UTC y moneda. Una métrica ausente no es lo mismo que un cero comunicado por el proveedor.
• Las cifras han dejado de actualizarse: revisa el proyecto seleccionado, el ajuste de actualización automática, la conexión de red y los errores del proveedor. Un límite de peticiones puede exigir esperar antes de volver a consultar.

Preguntas frecuentes

¿Necesito configurar un webhook o un servidor?

No. Esta integración de escritorio consulta directamente la API de Polar con el token guardado. No necesitas configurar un webhook para visualizar estas métricas.

¿Funciona en un Mac sin notch?

Sí. MakerNotch funciona con y sin notch, en macOS 14 o posterior. El tour de la app muestra cómo encaja el panel en el escritorio.

¿Puedo conectar Stripe y Polar al mismo proyecto?

Puedes conectar ambas integraciones y consultar sus vistas. Cada una conserva sus definiciones de métricas y monedas; MakerNotch no las fusiona en un informe financiero conciliado.

¿Conectar Polar sustituye a la activación de la licencia?

No. La activación de MakerNotch desbloquea la app. Polar es una integración opcional para consultar tu propia organización. Comprar MakerNotch no concede a la app acceso a tu negocio en Polar.