RevGlanceDocumentación

Polar

Conecta Polar con un token de acceso de la organización y añade un webhook para sincronizar al instante.

RevGlance lee los clientes, suscripciones y pedidos de tu organización de Polar con un token de acceso de la organización. Nunca cambia nada en Polar.

Conectar

  1. En Polar, abre los Settings de tu organización y crea un organization access token. Llámalo RevGlance.
  2. Dale los scopes customers:read, subscriptions:read y orders:read. Añade también customer_sessions:write si vas a enviar correos de recuperación.
  3. Copia el token. Empieza por polar_oat_.
  4. Pégalo en Token de acceso de la organización y elige Conectar Polar.

Qué pide el formulario

CampoAspecto
Token de acceso de la organizaciónSe guarda cifradopolar_oat_…

Añadir el webhook

  1. En RevGlance, abre Configuración › Fuentes, abre el menú de la fuente de Polar y elige Webhook. Copia la URL.
  2. En Polar, abre Settings › Webhooks de tu organización y añade un endpoint con esa URL. Elige los eventos de pedidos, suscripciones y reembolsos.
  3. Copia el secreto del webhook (whsec_…), pégalo en Secreto de firma en RevGlance y guarda.

Polar firma sus llamadas según Standard Webhooks. RevGlance acepta tanto la forma antigua como la actual en que Polar deriva la clave de un secreto whsec_, así que funciona un secreto creado antes o después del cambio de Polar de septiembre de 2026.

Qué sincroniza RevGlance

  • Clientes, con su país de facturación y sus metadatos, que pueden usar los filtros de segmentos.
  • Suscripciones, para el MRR, las plazas, los descuentos, las pruebas y las cancelaciones, con el motivo y el comentario del cliente cuando los dio.
  • Pedidos y sus reembolsos. La primera sincronización lee todos los pedidos; las posteriores leen desde tres días antes de la última, y una vez por semana vuelven a leer todos los pedidos, ya que un reembolso solo aparece en su pedido.

Cómo se cuenta Polar

  • Los pedidos cuentan antes de impuestos, con la comisión de plataforma de Polar como comisión. Una comisión en una moneda distinta a la del pedido aparece como cero.
  • Los reembolsos cuentan antes de impuestos, como el cobro. Polar no da fecha de reembolso, así que un reembolso se fecha con el último cambio del pedido.
  • Un reembolso de un pedido más antiguo se detecta con una lectura completa una vez por semana, así que puede aparecer hasta una semana tarde.
  • Los contracargos no se leen, así que uno perdido sigue contando como cobro salvo que el proveedor también lo informe como reembolso.
  • Los cobros fallidos no se informan, así que esa cifra se queda en cero.
  • El MRR es el importe de la suscripción, al que Polar ya resta un descuento recurrente. Un descuento puntual no reduce el MRR.
  • El MRR incluye el impuesto de los precios con impuestos incluidos: Polar no indica qué suscripciones los usan. Los cobros y los reembolsos cuentan antes de impuestos.

Correos de recuperación

Recuperar envía a los clientes a una sesión del portal de cliente de Polar para actualizar su tarjeta. Para eso el token necesita customer_sessions:write; sin él, el correo enlaza con tu propia página para actualizar la tarjeta.