RevGlanceConectando fontes
Como funcionam fontes, chaves, webhooks e sincronizações, qualquer que seja o seu provedor.
Uma fonte é uma conta em um provedor de pagamentos, conectada a um negócio. Um negócio pode ter várias fontes, inclusive do mesmo provedor: uma conta do Stripe e um app da App Store, ou duas contas do Stripe. Proprietários e administradores conectam fontes; visualizadores as veem.
Provedores compatíveis
Os provedores marcados como beta foram criados e testados com base na documentação do provedor, mas ainda não rodaram com uma conta real. Avise-nos se algum número for diferente dos relatórios do próprio provedor.
Chaves
Cada fonte se conecta com uma chave que você cria no provedor. O RevGlance armazena as credenciais criptografadas, nunca as mostra de novo e só lê. Prefira uma chave restrita ou somente leitura sempre que o provedor oferecer uma.
Dois recursos podem escrever, e só quando você permite isso na chave:
- Os e-mails de recuperação podem criar um link de atualização do cartão (uma sessão do portal do Stripe, uma sessão de cliente do Polar, uma transação de atualização de pagamento do Paddle).
- No modo privado, enviar e-mails de recuperação ou de pesquisa pede ao provedor o endereço do cliente no momento do envio.
Sincronização
- A primeira sincronização lê tudo o que o provedor guarda, exceto onde o provedor limita isso (a App Store guarda um ano de relatórios diários).
- As sincronizações seguintes leem a partir de três dias antes da última, para pegar mudanças tardias. O estado atual, como as assinaturas, é lido por completo.
- As fontes sincronizam a cada hora enquanto alguém usa o negócio. Quando ninguém entra há 30 dias, elas sincronizam uma vez por dia; ao voltar, tudo o que tiver mais de uma hora é sincronizado.
- Sincronizar agora, no status de sincronização da barra superior, sincroniza todas as fontes do negócio de uma vez.
Quando um provedor recusa uma solicitação, a fonte mostra o erro abaixo do nome dela em Configurações › Fontes. Uma sincronização parcial guarda sua posição, então a próxima execução lê a mesma janela de novo.
Webhooks
Um webhook permite que o provedor avise o RevGlance de que algo mudou, e o RevGlance coloca na fila uma sincronização dessa fonte na hora. Encontre o URL do webhook de uma fonte em Configurações › Fontes, no menu dela, em Webhook. Os provedores verificam webhooks de uma de três formas:
| Como | Provedores | O que você faz |
|---|---|---|
| Segredo de assinatura | Stripe, Polar, Lemon Squeezy, Paddle, Recurly | Cole o segredo de assinatura do provedor no RevGlance |
| Segredo no URL | Gumroad, App Store, Google Play, Chargebee | Salve um segredo aleatório no RevGlance e adicione ?token= e o segredo ao URL que você informa ao provedor |
| As próprias chaves da fonte | Braintree, Shopify | Nada: o provedor assina com as chaves que a fonte já tem |
Contagem
Cada provedor informa o dinheiro de um jeito um pouco diferente: reembolsos com ou sem impostos, com taxas ou sem, com datas de cancelamento ou não. O RevGlance uniformiza isso da mesma forma em todo lugar e diz onde não consegue. Cada guia de integração lista as regras do seu provedor, e Como contamos reúne todas elas em uma página.
Removendo uma fonte
Escolha Remover fonte no menu dela e mantenha o botão pressionado. Os pagamentos e as assinaturas dela são removidos junto; conectá-la de novo os traz de volta.