Documentação do RevenueUI
Rastreamento de receita
Conecte o Stripe, importe pagamentos e associe jornadas verificadas aos resultados.
Conecte o Stripe
Crie a chave restrita pelo link nas configurações.
| Permissão | Finalidade |
|---|---|
| Charges and refunds: Read | Conciliar pagamentos e reembolsos. |
| Subscriptions: Read | Calcular assinaturas e receita recorrente. |
| Balance: Read | Ler taxas e impacto de liquidação. |
| Disputes: Read | Acompanhar chargebacks, taxas e fundos devolvidos. |
| Credit Notes: Read | Incluir créditos sem duplicar reembolsos. |
| Webhook endpoints: Write | Administrar o endpoint assinado. |
A chave é verificada antes de ser salva e o histórico começa a ser importado.
Cobranças diretas do Stripe Connect
Deixe o Connected Account ID vazio, exceto quando os pagamentos forem direct charges criadas na conta conectada. Nesse caso, informe acct_.... Isso apenas define qual conta o RevenueUI lê; não move pagamentos. Não use para conta comum nem destination charges da plataforma.
Anexe metadados
Com cookies próprios, copie no backend:
cookie.revenueui_visitor_id -> metadata.revenueui_visitor_id
cookie.revenueui_session_id -> metadata.revenueui_session_id
Sem cookies, envie window.revenueUI?.getIdentifiers()?.sessionId ao backend e copie para metadata.revenueui_session_id. Nunca exponha credenciais do Stripe nem invente ou reutilize IDs entre sites.
Após consentimento, usuários autenticados podem usar identify(currentUser.id) e metadata.revenueui_user_id. Use um ID interno opaco; o RevenueUI aceita somente IDs já observados no mesmo site e armazena seu hash.
Entenda a cobertura
Pagamentos sem identidade ainda entram na receita do provedor, mas não em jornada, origem ou landing page. Sessões sem cookies atribuem o pagamento da mesma sessão, não visitas futuras, outras abas ou dispositivos. Valor de teste é expectativa, não receita recebida.
Receita e liquidação
- Receita após reembolsos: cobrança menos reembolsos, na moeda da cobrança.
- Taxas do Stripe: Balance Transactions relacionadas.
- Impacto de disputas: fundos retirados ou devolvidos e suas taxas.
- Ajustes de Credit Note: créditos pós-pagamento sem dupla subtração.
- Stripe líquido: impacto de cobrança, reembolsos e disputas na moeda de liquidação.
O gráfico usa a data do pagamento original para ajustes. Cobertura parcial é informada. Moedas de cobrança e liquidação diferentes não são somadas e nenhuma taxa de câmbio é estimada.
Recuperação e desconexão
Se o webhook for excluído, desconecte mantendo os dados e reconecte para criar um novo endpoint assinado. Ao desconectar, escolha cuidadosamente entre manter ou excluir permanentemente a receita importada.