RevGlanceConectar fuentes
Cómo funcionan las fuentes, las claves, los webhooks y las sincronizaciones, uses el proveedor que uses.
Una fuente es una cuenta en un proveedor de pagos, conectada a un negocio. Un negocio puede tener varias fuentes, también del mismo proveedor: una cuenta de Stripe y una app del App Store, o dos cuentas de Stripe. Los propietarios y administradores conectan fuentes; los lectores las ven.
Proveedores compatibles
Los proveedores marcados como beta se han creado y probado según la documentación del proveedor, pero todavía no se han usado con una cuenta real. Avísanos si un número difiere de los informes del propio proveedor.
Claves
Cada fuente se conecta con una clave que creas en el proveedor. RevGlance guarda las credenciales cifradas, nunca vuelve a mostrarlas y solo lee. Usa una clave restringida o de solo lectura siempre que el proveedor la ofrezca.
Dos funciones pueden escribir, y solo cuando lo permites en la clave:
- Los correos de recuperación pueden crear un enlace para actualizar la tarjeta (una sesión del portal de Stripe, una sesión de cliente de Polar, una transacción de actualización de pago de Paddle).
- En modo privado, enviar correos de recuperación o de encuesta pide al proveedor la dirección del cliente en el momento del envío.
Sincronización
- La primera sincronización lee todo lo que guarda el proveedor, salvo donde el proveedor lo limita (el App Store guarda un año de informes diarios).
- Las sincronizaciones posteriores leen desde tres días antes de la última, para captar los cambios tardíos. El estado actual, como las suscripciones, se lee completo.
- Las fuentes se sincronizan cada hora mientras alguien usa el negocio. Si nadie ha iniciado sesión en 30 días, se sincronizan una vez al día; al volver, se sincroniza todo lo que tenga más de una hora.
- Sincronizar ahora, en el estado de sincronización de la barra superior, sincroniza a la vez todas las fuentes del negocio.
Cuando un proveedor rechaza una petición, la fuente muestra el error bajo su nombre en Configuración › Fuentes. Una sincronización parcial conserva su posición, así que la siguiente vuelve a leer el mismo intervalo.
Webhooks
Un webhook permite que el proveedor avise a RevGlance de que algo cambió, y RevGlance pone en cola una sincronización de esa fuente al momento. Encontrarás la URL del webhook de una fuente en Configuración › Fuentes, en su menú, Webhook. Los proveedores verifican los webhooks de una de estas tres formas:
| Cómo | Proveedores | Qué haces |
|---|---|---|
| Secreto de firma | Stripe, Polar, Lemon Squeezy, Paddle, Recurly | Pega el secreto de firma del proveedor en RevGlance |
| Secreto en la URL | Gumroad, App Store, Google Play, Chargebee | Guarda un secreto aleatorio en RevGlance y añade ?token= y el secreto a la URL que le das al proveedor |
| Las claves de la fuente | Braintree, Shopify | Nada: el proveedor firma con las claves que la fuente ya tiene |
Cálculo
Cada proveedor informa del dinero de forma un poco distinta: reembolsos con o sin impuestos, con comisiones o sin ellas, con fechas de cancelación o sin ellas. RevGlance lo homogeneiza igual en todas partes e indica dónde no puede. Cada guía de integración recoge las reglas de su proveedor, y Cómo contamos las reúne todas en una página.
Quitar una fuente
Elige Quitar fuente en su menú y mantén pulsado el botón. Sus pagos y suscripciones se eliminan con ella; si vuelves a conectarla, regresan.