Integración completa de Stripe con Drupal: Desde cero hasta producción

El Objetivo: Facturar mientras duermes

Nuestro cliente perdía horas cada mes gestionando cobros y persiguiendo impagos. Necesitaban una solución que:

• Cobrará suscripciones mensuales y anuales automáticamente.
• Gestionara facturas e impuestos sin intervención humana.
• Permitiera a los usuarios actualizar sus tarjetas o planes solos.
• Cumpliera con toda la normativa de seguridad bancaria (PCI-DSS).

Arquitectura de la integración

Para esta integración, utilizamos una arquitectura que separa claramente las responsabilidades para máxima seguridad y modularidad:

Implementación paso a paso

// Configuración en settings.php o mediante variables de entorno
$settings['stripe_public_key'] = $_ENV['STRIPE_PUBLIC_KEY'];
$settings['stripe_secret_key'] = $_ENV['STRIPE_SECRET_KEY'];
$settings['stripe_webhook_secret'] = $_ENV['STRIPE_WEBHOOK_SECRET'];

// Ejemplo simplificado de integración frontend
const elements = stripe.elements();
const cardElement = elements.create('card');
cardElement.mount('#card-element');

// Manejo del submit del formulario
form.addEventListener('submit', async (event) => {
  event.preventDefault();
  const {token, error} = await stripe.createToken(cardElement);
  // Enviar token a Drupal para procesamiento
});

// Ejemplo de creación de cliente y suscripción
$customer = \Stripe\Customer::create([
  'email' => $user->getEmail(),
  'source' => $token,
]);

$subscription = \Stripe\Subscription::create([
  'customer' => $customer->id,
  'items' => [['price' => $price_id]],
]);

Manejo de suscripciones

Una de las partes más complejas fue el manejo de diferentes estados de suscripciones. Automatizamos la respuesta a cada escenario:

• Suscripción activaAcceso completo inmediato a la plataforma.
• Periodo de graciaSi el pago falla, damos unos días de acceso mientras reintentamos el cobro.
• Cancelada/ImpagoEl sistema revoca el acceso automáticamente y envía emails de recuperación.

Webhooks: La clave de la sincronización

Los webhooks mantienen Drupal actualizado en tiempo real. Por ejemplo, si una suscripción se renueva automáticamente en Stripe, Drupal recibe el aviso y extiende el acceso.

// Endpoint para manejar webhooks de Stripe
public function handleWebhook(Request $request) {
  // Verificación de firma y manejo de eventos...
  switch ($event->type) {
    case 'customer.subscription.created':
      // Activar suscripción
      break;
    case 'invoice.payment_succeeded':
      // Registrar factura
      break;
    case 'customer.subscription.deleted':
      // Revocar acceso
      break;
  }
}

Errores comunes y cómo evitarlos