Polar

Conecte o Polar com um token de acesso da organização e adicione um webhook para sincronizações instantâneas.

O RevGlance lê os clientes, assinaturas e pedidos da sua organização no Polar com um token de acesso da organização. Ele nunca altera nada no Polar.

Conectar

No Polar, abra as Settings da sua organização e crie um organization access token. Dê a ele o nome RevGlance.
Dê a ele os escopos customers:read, subscriptions:read e orders:read. Adicione também customer_sessions:write se você for enviar e-mails de recuperação.
Copie o token. Ele começa com polar_oat_.
Cole-o em Token de acesso da organização e escolha Conectar Polar.

O que o formulário pede

Campo	Formato
Token de acesso da organizaçãoArmazenado criptografado	`polar_oat_…`

Adicione o webhook

No RevGlance, abra Configurações › Fontes, abra o menu da fonte Polar e escolha Webhook. Copie o URL.
No Polar, abra Settings › Webhooks da sua organização e adicione um endpoint com esse URL. Escolha os eventos de pedido, assinatura e reembolso.
Copie o segredo do webhook (whsec_…), cole-o em Segredo de assinatura no RevGlance e salve.

O Polar assina suas chamadas no padrão Standard Webhooks. O RevGlance aceita tanto a forma antiga quanto a atual com que o Polar deriva a chave de um segredo whsec_, então um segredo criado antes ou depois da mudança do Polar de setembro de 2026 funciona.

O que o RevGlance sincroniza

Clientes, com o país de cobrança e os metadados, que os filtros de segmento podem usar.
Assinaturas, para MRR, licenças, descontos, testes e cancelamentos, com o motivo e o comentário do cliente quando ele deu um.
Pedidos e seus reembolsos. A primeira sincronização lê todos os pedidos; as seguintes leem a partir de três dias antes da última e, uma vez por semana, leem todos os pedidos de novo, já que um reembolso só aparece no pedido.

Como o Polar é contado

Os pedidos contam antes de impostos, com a taxa da plataforma do Polar como taxa. Uma taxa em moeda diferente da do pedido aparece como zero.
Os reembolsos contam antes de impostos, como a cobrança. O Polar não informa a data do reembolso, então ele é datado pela última alteração do pedido.
Um reembolso de um pedido mais antigo é captado por uma leitura completa uma vez por semana, então pode aparecer até uma semana depois.
Estornos não são lidos, então um perdido continua contado como cobrança, a menos que o provedor também o informe como reembolso.
Cobranças com falha não são informadas, então esse número fica em zero.
O MRR é o valor da assinatura, que o Polar já reduz por um desconto recorrente. Um desconto único não reduz o MRR.
O MRR inclui impostos em preços com impostos inclusos: o Polar não informa quais assinaturas os usam. Cobranças e reembolsos contam antes de impostos.

E-mails de recuperação

O Recuperar envia os clientes para uma sessão do portal do cliente do Polar para atualizar o cartão. Para isso, o token precisa de customer_sessions:write; sem isso, o e-mail leva à sua própria página de atualização do cartão.