Integración con Stripe
Procesa pagos de suscripción de forma segura con Stripe, la plataforma de pagos más utilizada a nivel global.
💡 ¿Por qué Stripe? Es la plataforma de pagos preferida por empresas como Shopify, Uber, Slack y miles más. Ofrece pagos instantáneos, suscripciones automáticas, y soporte para más de 135 monedas.
Ventajas de Stripe
🌍 Alcance Global
- Acepta tarjetas de cualquier país
- Más de 135 monedas soportadas
- Conversión automática de divisas
🔄 Pagos Recurrentes
- Cobros automáticos mensuales/anuales
- Reintentos automáticos si falla
- Gestión de suscripciones integrada
Moneda Principal
Stripe procesa los pagos de SGG principalmente en:
- USD - Dólar Estadounidense (moneda base)
- Otras monedas disponibles según la configuración del tenant
💵 Nota: Si tu moneda local no es USD, Stripe realizará la conversión automáticamente al tipo de cambio del momento. Verás el monto en tu moneda local en el extracto de tu tarjeta.
Flujo de Pago para el Usuario
Paso 1: Seleccionar Plan y Método de Pago
- Ve a Configuración → Planes y Suscripción
- Elige el plan que deseas (Starter, Pro, Enterprise)
- Selecciona Mensual o Anual
- Haz clic en "Pagar con Stripe"
Paso 2: Checkout de Stripe
Serás redirigido al checkout seguro de Stripe donde podrás:
Opciones de pago disponibles:
💳 Tarjetas de Crédito/Débito
- Visa, Mastercard, American Express
- Discover, Diners Club, JCB
- Tarjetas de débito internacionales
🔐 Wallets Digitales
- Apple Pay
- Google Pay
- Link (guardado de tarjetas)
Paso 3: Completar el Pago
- Ingresa los datos de tu tarjeta (número, fecha, CVV)
- Opcionalmente, ingresa tu email para recibir el recibo
- Haz clic en "Suscribirse" o "Pagar"
- Espera la confirmación del pago
Paso 4: Activación Automática
Pago Exitoso
Tu suscripción se activa instantáneamente. Serás redirigido a la página de éxito con los detalles de tu nueva suscripción.
Pago Fallido
Si el pago es rechazado, verás un mensaje de error con el motivo. Puedes intentar con otra tarjeta o método de pago.
Suscripciones Automáticas
Una ventaja clave de Stripe es el manejo automático de suscripciones:
🔄 Renovación Automática: Stripe guardará tu método de pago de forma segura y procesará automáticamente el cobro cuando corresponda (mensual o anual), sin que tengas que hacer nada.
Eventos de Suscripción
El sistema procesa automáticamente estos eventos de Stripe:
| Evento | Acción |
|---|---|
| checkout.session.completed | Activa tu suscripción |
| invoice.payment_succeeded | Renueva tu período de suscripción |
| invoice.payment_failed | Marca la suscripción como "vencida" |
| customer.subscription.updated | Actualiza fechas del período |
| customer.subscription.deleted | Cancela la suscripción |
Proceso Técnico (Para Desarrolladores)
// 1. Usuario inicia checkout
POST /api/{slug}/plans/checkout/stripe
Body: { planId: "...", billingCycle: "monthly" }
// 2. Backend crea/obtiene Stripe Customer
const customer = await stripe.customers.create({
email: owner.email,
name: tenant.name,
metadata: { tenantId, tenantSlug }
});
// 3. Crear Checkout Session
const session = await stripe.checkout.sessions.create({
customer: customerId,
mode: 'subscription',
line_items: [{
price: planPrice.stripeMonthlyPriceId,
quantity: 1
}],
success_url: '/admin/plans/success?session_id={CHECKOUT_SESSION_ID}',
cancel_url: '/admin/plans'
});
// 4. Frontend redirige al checkout
window.location.href = session.url;
// 5. Stripe notifica via webhook
POST /api/v1/subscriptions/stripe/webhook
// Verifica firma, procesa evento, actualiza suscripciónSeguridad de Stripe
🔒 Protección de Datos
- Certificación PCI DSS Nivel 1
- Cifrado AES-256 de datos
- Tokens en lugar de números de tarjeta
- SGG nunca almacena datos de tarjeta
🛡️ Verificación de Webhooks
- Firma criptográfica en cada webhook
- Verificación con STRIPE_WEBHOOK_SECRET
- Protección contra ataques de replay
- Logging de todos los eventos
Gestionar tu Suscripción
Cambiar de Plan
Puedes mejorar o reducir tu plan en cualquier momento:
- Ve a Configuración → Planes y Suscripción
- Selecciona el nuevo plan deseado
- Stripe calculará automáticamente el prorrateo
- Los cambios se aplican inmediatamente
Cancelar Suscripción
Para cancelar:
- Ve a Configuración → Cuenta
- Busca la opción de cancelar suscripción
- Tu acceso continuará hasta el fin del período pagado
- No se realizarán más cobros automáticos
¿Qué sigue?
Pagar con Mercado Pago →
Alternativa para pagos en pesos en Latinoamérica
Ver planes disponibles →
Compara características y precios de cada plan
Solución de Problemas
Mi tarjeta fue rechazada
Razones comunes de rechazo:
- Fondos insuficientes: Verifica tu saldo disponible
- Tarjeta vencida: Usa una tarjeta vigente
- Bloqueo por seguridad: Contacta a tu banco para autorizar la compra internacional
- CVV incorrecto: Verifica los 3 dígitos de seguridad
- Compras internacionales bloqueadas: Habilita compras en el exterior con tu banco
¿Cómo actualizo mi método de pago?
Para cambiar la tarjeta asociada a tu suscripción:
- Ve a Configuración → Planes y Suscripción
- Busca la opción "Actualizar método de pago"
- Serás redirigido a Stripe para ingresar la nueva tarjeta
- Los próximos cobros usarán la nueva tarjeta
Recibí un cobro inesperado
Posibles explicaciones:
- Es la renovación automática de tu suscripción
- Cambiaste de plan mensual a anual o viceversa
- Se procesó un cobro de prorrateo por cambio de plan
- Si crees que es un error, contacta a soporte con el ID del cargo
¿Dónde veo mis facturas?
Las facturas de Stripe se envían automáticamente al email registrado. También puedes:
- Ver el historial de pagos en Configuración → Planes y Suscripción
- Acceder al portal de cliente de Stripe (si está habilitado)
- Solicitar facturas adicionales a soporte
¿Puedo usar PayPal en lugar de Stripe?
Actualmente SGG solo soporta Stripe y Mercado Pago como procesadores de pago. PayPal no está disponible como opción directa. Sin embargo, algunas tarjetas de débito de PayPal pueden funcionar a través de Stripe.