Credencial Stripe - Pasarela de Pagos

Que es una credencial Stripe

Una credencial de Stripe permite a tus workflows procesar pagos, gestionar suscripciones, crear facturas y manejar operaciones financieras a traves de la pasarela de pagos Stripe.

---

Campos de configuración

Campo	Descripción	Ejemplo
Secret Key	Clave secreta para operaciones del servidor	sk_live_... o sk_test_...
Publishable Key	Clave publica para el lado del cliente	pk_live_... o pk_test_...

---

Como obtener las credenciales

Paso 1: Crear cuenta de Stripe

1. Ve a dashboard.stripe.com
2. Crea una cuenta si no tienes una
3. Completa la verificación de tu negocio para pagos en producción

Paso 2: Obtener claves de prueba

1. Asegurate de estar en modo Test (interruptor en la parte superior del dashboard)
2. Ve a Developers > API Keys
3. Copia la Publishable key (empieza con pk_test_)
4. Haz clic en Reveal test key para ver la Secret key (empieza con sk_test_)
5. Copia ambas claves

Paso 3: Obtener claves de producción

1. Completa la activación de tu cuenta en Settings > Account details
2. Cambia al modo Live con el interruptor superior
3. Ve a Developers > API Keys
4. Las claves de producción empiezan con pk_live_ y sk_live_

---

Modos de operación

• Test Mode: Usa las claves de prueba para desarrollo. Puedes usar tarjetas de prueba como 4242 4242 4242 4242
• Live Mode: Usa las claves de producción para transacciones reales. Requiere cuenta verificada

---

Solución de problemas

Error de autenticación

• Verifica que estes usando la Secret Key (no la Publishable Key) en Floogos
• Confirma que no estes mezclando claves de test con producción

Pagos rechazados en producción

• Verifica que tu cuenta este completamente activada
• Confirma que el método de pago del cliente sea valido
• Revisa los logs en Developers > Logs en el dashboard de Stripe

Webhooks no recibidos

• Verifica la URL del webhook en Developers > Webhooks
• Confirma que los eventos correctos esten suscritos
• Revisa los intentos de entrega en el dashboard

---

Seguridad

• Nunca expongas la Secret Key en código del lado del cliente o repositorios publicos
• La Publishable Key es segura para uso en el frontend
• Usa claves de prueba durante el desarrollo
• Configura claves restringidas (Restricted Keys) para limitar permisos
• Activa la autenticación de dos factores en tu cuenta de Stripe
• Verifica las firmas de los webhooks para prevenir solicitudes falsas
• Monitorea las transacciones regularmente desde el dashboard