Pagos (Stripe)
Genera enlaces de pago en las propuestas usando tu propia cuenta Stripe (modelo BYO).
La integración de Pagos usa TU cuenta Stripe (modelo BYO, "trae tu propia cuenta"). Los pagos caen directo en tu cuenta Stripe: no hay costo, margen ni intermediación de nuestra parte. Nosotros solo programamos los campos y el botón para generar el enlace.
La integración nace inerte: no ocurre nada hasta que pegues tu clave y actives. Las claves se guardan cifradas en el CRM y nunca se muestran de vuelta.
Requisitos previos
- Una cuenta Stripe activa (para cobrar de verdad, la cuenta debe estar habilitada para pagos en tu país).
- Acceso al Panel de Stripe con permiso para ver las claves de API (Developers → API keys) y crear webhooks (Developers → Webhooks).
- En Sellio, ser administrador para guardar las claves y activar la integración en Configuración → Integraciones.
Lo que necesitas pegar
- Secret key: en el Panel de Stripe, en Developers → API keys (comienza con sk_live_ en producción o sk_test_ en prueba).
- Webhook signing secret (opcional al inicio): generado cuando creas el webhook en Stripe (comienza con whsec_). Es lo que permite confirmar los pagos automáticamente.
Cómo configurar
- Abre Configuración → Integraciones y localiza la tarjeta "Pagos (Stripe)".
- Pega tu secret key de Stripe y haz clic en "Guardar claves".
- Copia la "URL del webhook de Stripe" que aparece y, en el Panel de Stripe (Developers → Webhooks), crea un endpoint para esa URL con los eventos checkout.session.completed y payment_intent.succeeded.
- Vuelve al CRM, pega el webhook signing secret (whsec_...) junto con la secret key y guarda nuevamente.
- Haz clic en "Activar".
Cómo generar un enlace de pago
- Abre una oportunidad y ve a la sección de Propuestas.
- En la versión deseada, haz clic en "Enlace de pago": el CRM crea un enlace en Stripe con el valor total de la propuesta y lo copia a tu portapapeles.
- Envía el enlace al cliente. Cuando pague, Stripe avisa al CRM por el webhook y el pago aparece como "Pagado" en la propuesta.
💡 Si intentas generar un enlace sin haber configurado Stripe, el CRM avisa de forma clara y no se cobra nada; la funcionalidad queda inerte hasta que la clave esté en su lugar. Cuando se confirma un pago vinculado a una propuesta, la propuesta se marca como aceptada automáticamente.
Trata la URL del webhook como secreta y pega siempre las dos claves juntas al cambiarlas (por seguridad, el CRM no muestra las claves guardadas de vuelta).
Cómo probar
- Usa las claves de PRUEBA (sk_test_.../whsec_ del modo de prueba) para no cobrar de verdad.
- Genera un "Enlace de pago" en una propuesta y ábrelo: debes llegar al checkout de Stripe con el valor total de la propuesta.
- Paga con una tarjeta de prueba de Stripe (ej.: 4242 4242 4242 4242). Confirma que la propuesta pasa a "Pagado" y se marca como aceptada: es señal de que el webhook llegó y la firma coincidió.
- En el Panel de Stripe (Developers → Webhooks → tu endpoint), observa el historial de eventos entregados y el estado 200.
Solución de problemas
- Error al generar el enlace / 401 en Stripe: la secret key es incorrecta o es de otro modo (pegaste la de prueba pero estás en producción, o viceversa). Vuelve a pegar la sk_ correcta.
- El cliente paga pero la propuesta no pasa a "Pagado": el webhook no está confirmando. Verifica que creaste el endpoint en Stripe apuntando a la "URL del webhook de Stripe" con los eventos checkout.session.completed y payment_intent.succeeded.
- Firma inválida en el webhook: el webhook signing secret (whsec_...) en el CRM no coincide con el del endpoint en Stripe. Copia el secret del endpoint y pégalo JUNTO con la secret key (guarda las dos juntas).
- 404 en la URL del webhook: la integración no está activada o el token de la URL cambió; reactiva y vuelve a copiar la URL a Stripe.
- No ocurre nada al generar el enlace: la integración está inerte por falta de clave. Pega la secret key y activa primero.