Stripe
Conecta Stripe con una clave restringida de solo lectura y añade un webhook para que los pagos nuevos aparezcan al momento.
RevGlance lee tu cuenta de Stripe a través de la API de Stripe con una clave que creas tú. Lee cobros, reembolsos, comisiones, disputas y suscripciones, y nunca cobra, reembolsa ni cambia nada.
Antes de empezar
- Tienes que ser propietario o administrador del negocio en RevGlance. Los lectores no pueden añadir fuentes.
- Usa una restricted key en lugar de tu clave secreta. RevGlance acepta ambas (
rk_…osk_…), pero una clave restringida solo puede leer lo que tú permitas. - Las claves del modo de prueba también funcionan, lo que viene bien para un primer vistazo. Conecta una segunda fuente con tu clave live cuando estés listo.
Conectar
- En el Stripe Dashboard, abre Developers › API keys y elige Create restricted key. Llámala RevGlance.
- Dale acceso Read a Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions y Coupons. Deja todo lo demás en None.
- Crea la clave y cópiala. Empieza por
rk_live_. - Pégala en Clave restringida y elige Conectar Stripe. La primera sincronización lee todo tu historial.
Qué pide el formulario
| Campo | Aspecto |
|---|---|
| Clave restringidaSe guarda cifrado | rk_live_… |
El campo Nombre es opcional. Sirve para distinguir dos cuentas de Stripe en un mismo negocio.
Añadir el webhook
Sin webhook, RevGlance sincroniza Stripe cada hora. Con uno, un pago, reembolso o cancelación nuevo pone en cola una sincronización en segundos.
- En RevGlance, abre Configuración › Fuentes, busca la fuente de Stripe, abre su menú y elige Webhook. Copia la URL.
- En Stripe, abre Developers › Webhooks y añade un endpoint con esa URL.
- Selecciona los eventos que cambian tus números:
charge.succeeded,charge.failed,charge.refunded,charge.dispute.closed,customer.subscription.created,customer.subscription.updated,customer.subscription.deletedeinvoice.paid. Cualquier evento sirve: cada uno simplemente inicia una sincronización. - Copia el signing secret del endpoint (
whsec_…), pégalo en Secreto de firma en RevGlance y guarda.
Qué sincroniza RevGlance
- Balance transactions: cada cobro, reembolso, disputa y comisión de Stripe, en la moneda en que Stripe lo liquidó.
- Cobros fallidos, para la métrica de cobros fallidos y Recuperar.
- Suscripciones en cualquier estado, con su cliente, sus elementos, sus descuentos y su última factura, para el MRR, los planes, las pruebas y las cancelaciones. El motivo de cancelación de Stripe y el comentario del cliente se incluyen cuando Stripe los tiene.
La primera sincronización lee todo tu historial. Después, cada sincronización lee desde tres días antes de la última, para captar los cambios tardíos, y las suscripciones se leen completas cada vez.
Cómo se cuenta Stripe
- Los cobros, reembolsos y comisiones de Stripe salen de tus transacciones de saldo, en la moneda en que Stripe las liquidó.
- Los reembolsos con tarjeta cuentan el día en que Stripe los registra. Los pagos bancarios (ACH, SEPA y otros métodos locales) también cuentan; un reembolso que el banco devuelve vuelve a reducir tus reembolsos.
- Una disputa cuenta como reembolso cuando Stripe retira el dinero, y el reembolso se anula si la ganas. La comisión por disputa de Stripe se mantiene como comisión.
- Los cupones de la suscripción y de artículos sueltos se restan del MRR. Un cupón de importe fijo solo cuenta en su propia moneda.
- Las suscripciones en pausa e impagadas cuentan como baja; una con el pago vencido sigue contando mientras Stripe reintenta la tarjeta.
- Los cobros, reembolsos y disputas cuentan antes de impuestos, en la proporción de impuesto de su factura o Checkout Session. Sin acceso de lectura a Checkout Sessions, el impuesto de las ventas fuera de una factura queda incluido.
- Un precio con impuestos incluidos cuenta antes de impuestos en el MRR, en la proporción de impuesto de la última factura.
- Pausar el cobro de pagos cuenta como baja desde el día en que RevGlance lo ve por primera vez, ya que Stripe no le pone fecha.
Consulta Cómo contamos para ver las reglas que se aplican a todos los proveedores.
Correos de recuperación
Recuperar enlaza un pago de suscripción fallido con la página de su factura abierta en Stripe, donde el cliente puede pagar con una tarjeta nueva. Cuando no hay factura abierta, abre en su lugar una sesión del portal de cliente de Stripe. Esa alternativa necesita el portal activado en Stripe y una clave con permiso de escritura para sesiones de Customer portal; sin ello, el correo enlaza con tu propia página para actualizar la tarjeta.
Solución de problemas
- "Pega una clave secreta o restringida de Stripe." La clave debe empezar por
rk_osk_. Una clave publicable (pk_) no puede leer nada. - "Stripe refused that key." La clave se revocó o no tiene acceso de lectura a Balance.
- "Stripe refused the failed-charge request" o "the subscription request": la clave no puede leer Charges o Subscriptions. Los pagos siguen sincronizándose; añade el permiso que falta y vuelve a sincronizar.

RevGlance