RevGlanceDocumentação

Lemon Squeezy

Conecte o Lemon Squeezy com uma chave de API e um webhook assinado.

O RevGlance lê os produtos, clientes, pedidos, assinaturas e faturas de assinatura da sua loja Lemon Squeezy com uma chave de API.

Conectar

  1. No Lemon Squeezy, abra Settings › API e crie uma nova chave de API. Dê a ela o nome RevGlance.
  2. Copie a chave na hora: o Lemon Squeezy a mostra uma única vez.
  3. Cole-a em Chave de API e escolha Conectar Lemon Squeezy. O RevGlance lê produtos, clientes, pedidos, assinaturas e as faturas delas.

O que o formulário pede

CampoFormato
Chave de APIArmazenado criptografadoeyJ0eXAiOiJKV1Qi…

Adicione o webhook

  1. No RevGlance, abra Configurações › Fontes, abra o menu da fonte Lemon Squeezy e escolha Webhook. Copie o URL.
  2. No Lemon Squeezy, abra Settings › Webhooks e adicione um webhook com esse URL. Invente um signing secret longo e aleatório e selecione os eventos de pedido, assinatura e pagamento de assinatura.
  3. Cole o mesmo segredo em Segredo de assinatura no RevGlance e salve.

O que o RevGlance sincroniza

  • Variantes, para distinguir assinaturas de produtos únicos e ler o intervalo de cada plano.
  • Assinaturas, lidas por completo a cada vez, para MRR, planos, testes e cancelamentos.
  • Clientes, pedidos e faturas de assinatura. O Lemon Squeezy lista esses itens do mais novo para o mais antigo, sem filtro de data, então as sincronizações seguintes leem até 60 dias antes da última sincronização e, uma vez por semana, leem tudo de novo, para captar reembolsos de pedidos mais antigos.

Como o Lemon Squeezy é contado

  • As cobranças são o total do pedido ou da fatura menos impostos.
  • O Lemon Squeezy informa reembolsos com impostos, então o RevGlance retira os impostos proporcionalmente. Pode haver um centavo de arredondamento de vez em quando.
  • Reembolsos totais são datados quando o Lemon Squeezy os fez. Reembolsos parciais não têm data, então aparecem na data da fatura.
  • Uma assinatura cancelada continua contando até o fim do período pago. Uma não paga (quatro tentativas com falha) conta como churn e volta se o pagamento for recuperado.
  • O Lemon Squeezy não envia data nem motivo de cancelamento: a data de cancelamento é a da última alteração da assinatura.
  • O Lemon Squeezy não informa taxas, então as taxas aparecem como zero.
  • Um desconto é descontado do MRR assim que uma renovação o mostra. O Lemon Squeezy não informa se um desconto se repete, então um que esteja só na primeira fatura não conta.
  • Um reembolso de um pedido mais antigo é captado por uma leitura completa uma vez por semana, então pode aparecer até uma semana depois.
  • Um teste convertido antes de você conectar não é mostrado, já que o Lemon Squeezy só indica um teste enquanto ele está ativo.
  • 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.