Documentación de RevenueUI
Seguimiento de ingresos
Conecta Stripe, importa pagos y asocia recorridos verificados con resultados.
Conecta Stripe
Crea la clave restringida desde el enlace de configuración.
| Permiso | Propósito |
|---|---|
| Charges and refunds: Read | Conciliar pagos y reembolsos. |
| Subscriptions: Read | Calcular suscripciones e ingresos recurrentes. |
| Balance: Read | Leer comisiones e impacto de liquidación. |
| Disputes: Read | Seguir contracargos, comisiones y fondos devueltos. |
| Credit Notes: Read | Incluir créditos sin duplicar reembolsos. |
| Webhook endpoints: Write | Gestionar el endpoint firmado. |
La clave se valida antes de guardar y después comienza la importación histórica.
Cobros directos de Stripe Connect
Deja Connected Account ID vacío salvo que los pagos sean direct charges creados en la cuenta conectada. Entonces introduce acct_.... Solo indica qué cuenta leer; no mueve pagos. No lo uses para una cuenta normal ni destination charges de plataforma.
Adjunta metadatos
Con cookies propias, copia en el backend:
cookie.revenueui_visitor_id -> metadata.revenueui_visitor_id
cookie.revenueui_session_id -> metadata.revenueui_session_id
Sin cookies, envía window.revenueUI?.getIdentifiers()?.sessionId y copia a metadata.revenueui_session_id. Nunca expongas credenciales, inventes IDs ni los reutilices entre sitios.
Tras consentimiento, usuarios autenticados pueden usar identify(currentUser.id) y metadata.revenueui_user_id. Debe ser un ID interno ya observado en el mismo sitio; RevenueUI almacena su hash.
Entiende la cobertura
Un pago sin identidad cuenta en ingresos del proveedor, pero no en recorrido, fuente o landing. Una sesión sin cookies atribuye el pago de la misma sesión, no visitas futuras, otras pestañas o dispositivos. El valor de prueba es una expectativa, no ingreso cobrado.
Ingresos y liquidación
- Ingresos tras reembolsos: cobro menos reembolsos en su moneda.
- Comisiones de Stripe: Balance Transactions relacionadas.
- Impacto de disputas: fondos retirados o devueltos y comisiones.
- Ajustes de Credit Note: créditos posteriores sin doble resta.
- Neto de Stripe: impacto de cobro, reembolsos y disputas en moneda de liquidación.
El gráfico asigna los ajustes a la fecha original y etiqueta cobertura parcial. No mezcla monedas distintas ni estima cambios.
Recuperación y desconexión
Si se elimina el webhook, desconecta conservando datos y vuelve a conectar para crear otro endpoint firmado. Al desconectar, elige con cuidado entre conservar o borrar permanentemente los ingresos importados.