Stripe

O RevGlance lê sua conta do Stripe pela API do Stripe com uma chave que você cria. Ele lê cobranças, reembolsos, taxas, contestações e assinaturas, e nunca cobra, reembolsa ou altera nada.

Antes de começar

• Você precisa ser proprietário ou administrador do negócio no RevGlance. Visualizadores não podem adicionar fontes.
• Use uma chave restrita em vez da sua secret key. O RevGlance aceita as duas (rk_… ou sk_…), mas uma chave restrita só lê o que você permite.
• Chaves do modo de teste também funcionam, o que é útil para uma primeira olhada. Conecte uma segunda fonte com sua chave de produção quando estiver pronto.

Conectar

O que o formulário pede

O campo Nome é opcional. Ele distingue duas contas do Stripe em um mesmo negócio.

Adicione o webhook

Sem um webhook, o RevGlance sincroniza o Stripe a cada hora. Com um, um novo pagamento, reembolso ou cancelamento coloca uma sincronização na fila em segundos.

O que o RevGlance sincroniza

• Transações de saldo: cada cobrança, reembolso, contestação e taxa do Stripe, na moeda em que o Stripe a liquidou.
• Cobranças com falha, para a métrica de cobranças com falha e o Recuperar.
• Assinaturas de todos os status, com o cliente, os itens, os descontos e a fatura mais recente, para MRR, planos, testes e cancelamentos. O motivo de cancelamento do Stripe e o comentário do cliente vêm junto quando o Stripe os tem.

A primeira sincronização lê todo o seu histórico. Depois disso, cada sincronização lê a partir de três dias antes da última, para pegar mudanças tardias, e as assinaturas são lidas por completo todas as vezes.

Como o Stripe é contado

• Cobranças, reembolsos e taxas do Stripe vêm das suas transações de saldo, na moeda em que o Stripe as liquidou.
• Reembolsos de cartão contam no dia em que o Stripe os registra. Pagamentos bancários (ACH, SEPA e outros métodos locais) também contam; um reembolso que o banco devolve reduz seus reembolsos de novo.
• Uma contestação conta como reembolso quando o Stripe recupera o dinheiro, e o reembolso é cancelado se você ganhar. A taxa de contestação do Stripe é mantida como taxa.
• Cupons na assinatura e em itens individuais são descontados do MRR. Um cupom de valor fixo só conta na própria moeda.
• Assinaturas pausadas e não pagas contam como churn; uma em atraso continua contando enquanto o Stripe tenta cobrar o cartão de novo.
• Cobranças, reembolsos e contestações contam antes de impostos, na proporção de impostos da fatura ou Checkout Session. Sem acesso de leitura a Checkout Sessions, os impostos das vendas fora de uma fatura permanecem incluídos.
• Um preço com impostos inclusos conta antes de impostos no MRR, na proporção de impostos da fatura mais recente.
• Pausar a cobrança de pagamentos conta como churn a partir do dia em que o RevGlance a vê pela primeira vez, já que o Stripe não a data.

Veja Como contamos para as regras que valem para todos os provedores.

E-mails de recuperação

O Recuperar liga um pagamento de assinatura com falha à página da fatura em aberto no Stripe, onde o cliente pode pagar com um cartão novo. Quando não há fatura em aberto, ele abre uma sessão do portal do cliente do Stripe. Essa alternativa exige o portal ativado no Stripe e uma chave com permissão para escrever sessões de Customer portal; sem isso, o e-mail leva à sua própria página de atualização do cartão.

Solução de problemas

• "Cole uma chave secreta ou restrita do Stripe." A chave precisa começar com rk_ ou sk_. Uma chave publicável (pk_) não consegue ler nada.
• "Stripe refused that key." A chave foi revogada ou não tem acesso de leitura a Balance.
• "Stripe refused the failed-charge request" ou "the subscription request": a chave não consegue ler Charges ou Subscriptions. Os pagamentos continuam sincronizando; adicione a permissão que falta e sincronize de novo.