Qué es Stripe y para qué lo necesitas
Stripe es la pasarela de pago con la que tus clientas pagan con tarjeta cuando reservan en tu web. Los cobros van directamente a tu cuenta de Stripe, no a Godolphy.
Lo necesitas si quieres cobrar el servicio o un depósito al reservar, cobrar el resto con la tarjeta guardada o aplicar tu política de cancelación y no-show a la tarjeta. Si prefieres que tus clientas paguen siempre en el salón, no hace falta conectarlo.
Necesitas una cuenta de Stripe activada. Si no la tienes, créala en stripe.com. Ten abiertos a la vez el panel de Godolphy y el de Stripe: vas a copiar datos de uno a otro.
Dónde se conecta
En el menú lateral, entra en Configuración y abre la pestaña Configuración. Baja hasta el bloque Integración Stripe.
1. Crea el webhook en Stripe
El webhook es el aviso que Stripe envía a Godolphy cada vez que se paga, se retiene o se devuelve un importe. Sin él, las reservas pagadas con tarjeta no se confirman.
- En Godolphy, en el bloque Webhook de Stripe, pulsa Copiar para copiar la URL de tu salón.
- En Stripe, ve a Desarrolladores → Webhooks → Añadir destino y pega esa URL.
- Selecciona los eventos que aparecen en Godolphy debajo de la URL:
payment_intent.succeededpayment_intent.amount_capturable_updatedpayment_intent.payment_failedpayment_intent.canceledcharge.refundedpayment_method.attachedpayment_method.detached
- Guarda el destino en Stripe y copia su Secreto de firma (empieza por
whsec_). Lo pegarás en el paso siguiente.
2. Pega las claves en Godolphy
Las claves están en Stripe, en dashboard.stripe.com/apikeys (en Godolphy tienes el enlace debajo de los campos). En el bloque Claves de producción rellena:
- Clave pública de producción (pk_live_...).
- Clave secreta de producción (sk_live_...).
- Endpoint secret de producción (whsec_...): el secreto de firma del webhook.
Pulsa Guardar datos. Verás «Claves de Stripe añadidas con éxito».
Una vez guardadas, las claves secretas se muestran ocultas: solo verás los últimos caracteres. Para cambiar una clave, pega la nueva encima y vuelve a guardar.
3. Si quieres probar antes: el modo de prueba
Stripe tiene un modo de prueba con tarjetas ficticias, sin cargos reales. Para usarlo:
- En Stripe, cambia a modo de prueba y crea también allí el webhook (con la misma URL y los mismos eventos).
- En Godolphy, rellena las tres Claves de prueba (
pk_test_,sk_test_y suwhsec_) y pulsa Guardar datos. - Activa Modo de prueba. Se guarda al momento y verás el aviso «Modo de prueba activado. Los pagos no son reales.».
Acuérdate de desactivarlo cuando acabes de probar. Mientras esté activo, tus clientas no pagan de verdad.
Siguiente paso
Con Stripe conectado, decide cuánto cobras al reservar en Cobro al reservar: pago completo o depósito.
Haz una reserva de prueba antes de anunciarlo
Prueba el recorrido completo como si fueras una clienta. Con el modo de prueba activado, reserva en tu propia web con una tarjeta de prueba de Stripe y comprueba que la cita aparece en tu calendario como pagada. Así sabes que el webhook funciona antes de que una clienta real se encuentre un problema.
Cobrar al reservar reduce las citas perdidas. Una clienta que ya ha pagado o ha dejado un depósito falta mucho menos. Te lo contamos en cómo evitar las citas canceladas en tu salón y en la página de pagos y depósitos.
Errores habituales
- Me sale «… debe empezar por …» al guardar
- Has pegado una clave en el campo que no toca. Las públicas empiezan por
pk_, las secretas porsk_y el endpoint secret porwhsec_. Las de producción llevanlivey las de pruebatest. - Me sale «Stripe dice que la clave no es válida»
- La clave secreta está mal copiada o es de otra cuenta. Cópiala de nuevo desde Stripe, entera.
- No me deja activar o desactivar el modo de prueba
- Para cambiar de modo, el modo al que pasas tiene que tener sus tres claves. El mensaje te dice cuáles faltan.
- Las clientas pagan pero la reserva no se confirma
- Casi siempre es el webhook. Revisa que en Stripe esté creado con la URL de tu salón, que tenga todos los eventos de la lista y que el Endpoint secret que has pegado en Godolphy sea el de ese webhook y del mismo modo (producción o prueba).
- Una clienta no puede pagar al reservar
- Si pides el pago al reservar y Stripe no está conectado, tus clientas no pueden terminar el pago online. Conecta Stripe o desactiva el pago al reservar en Configuración → Pagos.
