Cómo migrar de Stripe a Polar en 2 horas
Guía paso a paso para migrar un SaaS Next.js de Stripe a Polar: abstracción de pagos, webhooks, sandbox y deploy en sombra.
Este blog es de CREA.MBA, un boilerplate de Next.js con auth, pagos y panel de admin ya montados. Ver qué incluye
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/sdkManté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=productionPaso 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:
- Crea cuenta sandbox + productos en sandbox
- Configura
POLAR_SERVER=sandbox - Haz una compra de prueba con tarjeta
4242 4242 4242 4242 - Verifica que el webhook llega y la DB se actualiza
- 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.
¿Te gustó este artículo?
Suscríbete para más tutoriales y tips sobre crear productos con IA