RevGlanceDocumentação

Recurly

Conecte o Recurly com uma chave de API privada, na região dos EUA ou da UE.

O RevGlance lê a versão 2021-02-25 da API do Recurly: faturas de cobrança pagas, transações de reembolso e assinaturas.

Conectar

  1. No Recurly, abra Integrations › API Credentials e adicione uma chave de API privada. Dê a ela o nome RevGlance.
  2. Copie a chave e anote o subdomínio do seu site: acme para acme.recurly.com.
  3. Preencha a chave, a região em que seu site está hospedado (us ou eu) e o subdomínio, e escolha Conectar Recurly.

O que o formulário pede

CampoFormato
Chave de API privadaArmazenado criptografado0123456789abcdef0123456789abcdef
Regiãous ou eu
Subdomínio do siteacme (de acme.recurly.com)

Informe us ou eu como região. Sites hospedados na UE usam a API da UE do Recurly.

Adicione o webhook

  1. No RevGlance, abra Configurações › Fontes, abra o menu da fonte Recurly e escolha Webhook. Copie o URL.
  2. No Recurly, abra Integrations › Webhooks e adicione um endpoint com esse URL no formato JSON.
  3. Copie o segredo de assinatura do endpoint, cole-o em Segredo de assinatura no RevGlance e salve.

O RevGlance verifica o cabeçalho recurly-signature e recusa chamadas com mais de cinco minutos.

O que o RevGlance sincroniza

  • Faturas de cobrança pagas, antes dos impostos.
  • Transações de reembolso bem-sucedidas, descontando os impostos na mesma proporção da fatura.
  • Assinaturas, para MRR, planos, testes e cancelamentos. O Recurly não informa motivo de cancelamento pela API nem taxas de gateway.

Como o Recurly é contado

  • Faturas de cobrança pagas contam antes de impostos.
  • Reembolsos são as transações de reembolso bem-sucedidas. Elas incluem impostos, então o RevGlance retira os impostos na mesma proporção da fatura.
  • O Recurly não informa taxas do gateway, então as taxas aparecem como zero.
  • O MRR é o subtotal do Recurly para a assinatura (valor unitário, quantidade e complementos, após cupons, antes de impostos).
  • Uma assinatura cancelada continua contando até expirar; as expiradas, com falha e pausadas contam como churn. O Recurly não informa motivo de cancelamento pela API.
  • Um pagamento que não pôde ser cobrado conta como cobrança com falha. Não movimenta dinheiro.
  • 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.

E-mails de recuperação

O Recuperar leva o cliente à página de conta hospedada dele no seu site Recurly, e é por isso que o formulário pede o subdomínio.