Cómo migrar de Stripe a Polar en 2 horas

Si tienes un SaaS indie vendiendo a Europa, probablemente has notado el tirón de migrar de Stripe a Polar. La razón principal: Polar es Merchant of Record y se ocupa del IVA por ti.

La migración técnica no es tan dolorosa como suena. Si tu integración de Stripe está bien modularizada, son ~2 horas de trabajo. Esta guía explica cómo lo haríamos en una app Next.js existente.

Antes de migrar: qué NO se mueve

• Suscripciones activas: no migran automáticamente. Polar no importa de Stripe. Los clientes existentes siguen en Stripe hasta que renueven o cambien de plan.
• Historial de pagos: no se transfiere. Déjalo en Stripe como archivo.
• Métodos de pago guardados: tampoco. Polar pedirá la tarjeta de nuevo.

Por eso la migración funciona mejor con un SaaS joven (< 100 suscripciones) o con un cambio gradual: clientes nuevos en Polar, antiguos siguen en Stripe hasta que churneen.

Paso 1: instalar Polar

bun add @polar-sh/sdk

Mantén stripe por ahora; lo eliminas al final.

Paso 2: variables de entorno

Mantén las de Stripe y añade las de Polar:

POLAR_ACCESS_TOKEN=polar_oat_...
POLAR_WEBHOOK_SECRET=whsec_...
POLAR_SERVER=production

Paso 3: crear productos en Polar Dashboard

Replica los productos que tienes en Stripe. Ojo con:

• Precios: Polar trabaja en céntimos como Stripe. Pero si tienes precios con IVA incluido en Stripe, en Polar pones el precio neto y Polar añade IVA al cliente final. Decide si tu pricing visible cambia.
• Recurring intervals: monthly, yearly. Polar los soporta.
• One-time products: también, igual que Stripe.

Paso 4: abstraer la lógica de pagos

Si ya tienes una capa de abstracción tipo PaymentService o lib/payments/, esto lo tienes hecho. Si no, ahora es el momento.

src/lib/payments/types.ts:

export interface PaymentProvider {
  createCheckout(params: CheckoutParams): Promise<{ url: string }>;
  cancelSubscription(subscriptionId: string): Promise<void>;
  verifyWebhook(body: string, signature: string): Promise<WebhookEvent>;
}

Implementa StripeProvider y PolarProvider. Cambias entre ellos con una env var:

const provider =
  process.env.PAYMENT_PROVIDER === 'polar' ? new PolarProvider() : new StripeProvider();

Paso 5: nuevo endpoint de webhook Polar

Stripe y Polar firman webhooks de forma distinta. Crea un endpoint nuevo, no modifiques el de Stripe:

src/app/api/webhooks/polar/route.ts:

import { polar } from '@/lib/polar/client';
import { db } from '@/lib/db/client';

export async function POST(req: Request) {
  const body = await req.text();
  const signature = req.headers.get('webhook-signature')!;

  const event = polar.webhooks.verify({
    body,
    signature,
    secret: process.env.POLAR_WEBHOOK_SECRET!,
  });

  // Reusa la lógica del webhook de Stripe, adaptada a eventos de Polar
  switch (event.type) {
    case 'subscription.created':
      // crear en DB
      break;
    case 'subscription.canceled':
      // marcar como canceled
      break;
  }

  return new Response('OK');
}

Paso 6: estrategia de cohortes

En tu DB, añade un campo paymentProvider a la tabla de suscripciones:

model Subscription {
  id              String   @id
  userId          String
  paymentProvider String   // 'stripe' | 'polar'
  externalId      String   // ID en Stripe o Polar
  status          String
  ...
}

Cuando un usuario cancela y se vuelve a suscribir, su nueva suscripción va a Polar. Las antiguas se quedan en Stripe hasta que churneen.

Paso 7: probar en sandbox

Polar tiene sandbox separado. Antes de tocar producción:

1. Crea cuenta sandbox + productos en sandbox
2. Configura POLAR_SERVER=sandbox
3. Haz una compra de prueba con tarjeta 4242 4242 4242 4242
4. Verifica que el webhook llega y la DB se actualiza
5. Verifica la cancelación

Cuando todo funciona en sandbox → cambia a production.

Paso 8: shadow deploy

No anuncies la migración el día 1. Despliega Polar en producción con:

• Botón "Pagar con Polar" oculto detrás de un feature flag
• Activas el flag para tu cuenta de prueba
• Haces una compra real
• Verificas que Polar te transfiere el dinero a tu cuenta bancaria
• Activas para todos los signups nuevos

Errores comunes

1. Webhook duplicado: si reproduces el mismo evento, asegúrate de que tu DB no crea suscripciones duplicadas. Indexa por externalId.

2. IVA en pricing visible: si Stripe mostraba "10€ IVA incluido", en Polar el cliente verá "10€ + IVA" porque Polar lo calcula. O bajas el precio neto, o subes el visible. Comunica.

3. Reembolsos y disputes: la lógica es distinta. Lee la documentación de Polar antes del primer reembolso.

Conclusión

Migrar Stripe → Polar son ~2 horas de código si tienes la abstracción hecha, o ~1 día desde cero. La parte más larga es probar en sandbox y hacer el shadow deploy.

A cambio: te olvidas del IVA, de la liquidación OSS, del gestor discutiendo qué tipo de servicio es un SaaS. Si vendes a Europa, vale la pena.