Saltar al contenido principal

Flujo actual del producto · 11 puntos de control

Migra todas las suscripciones Stripe sin improvisar el corte

Esta es la guía operativa completa de MoveMRR: qué seleccionar, por qué existe cada fase, qué puede fallar y qué evidencias necesitas antes de continuar.

El proceso

Conectar → Catálogo → Clientes → Configurar → Ensayar → Ejecutar → Verificar

Tiempo de trabajo

Aproximadamente 1–2 horas más el procesamiento de Stripe

Acceso necesario

Administrador de Stripe en origen y destino

Opción segura

Ensayar en Sandbox antes de Live

?

Una decisión antes de empezar

Si tus sandboxes de Stripe ya contienen suscripciones y catálogo realistas, sigue esta guía completa. Si están vacías, detente después de Conectar, utiliza la guía de seeding y vuelve después a Catálogo.

Empezar la guía principal Mis sandboxes están vacías →
1 Antes de empezar

Preparar las dos cuentas Stripe y elegir el entorno

Una migración es un corte coordinado entre la cuenta de origen del vendedor y la cuenta de destino del comprador. Definir ahora esos papeles evita el error más peligroso: crear o cancelar objetos en la cuenta equivocada.

Haz esto

  1. 1

    Asignar una persona responsable a cada lado

    Mantén disponible una persona con acceso de administrador de Stripe al origen y otra al destino. Ambas deben tener autenticación en dos pasos y poder crear claves API restringidas.

  2. 2

    Elegir Sandbox o migración Live

    Empieza con Sandbox para ensayar sin riesgo en modo de prueba de Stripe. Los proyectos Sandbox son gratuitos, usan claves de prueba y no requieren exención de responsabilidad. Elige Live solo para producción: crea suscripciones reales, puede afectar cobros reales y consume una licencia.

  3. 3

    Elegir una ventana operativa tranquila

    Evita cambios en productos, precios, cupones, clientes y suscripciones durante el ensayo final y la ejecución Live. Si el equipo debe cambiar algo, termínalo primero y vuelve a validar la preparación.

  4. 4

    Anotar el ID de la cuenta de destino

    Copia en el Dashboard de destino el ID de cuenta que empieza por acct_. Lo necesitarás cuando la cuenta de origen envíe la Customer Data Copy.

Continúa solo cuando

  • Puedes alternar entre ambas cuentas Stripe sin perder acceso.
  • Sabes qué cuenta es el origen y cuál es el destino.
  • Has decidido si el proyecto es un ensayo Sandbox o el corte Live.

Atención

Un proyecto Sandbox de MoveMRR y una sandbox de Stripe están relacionados, pero no son lo mismo: MoveMRR conecta dos entornos de prueba de Stripe. Si están vacíos, usa la guía opcional de seeding después de Conectar.

2 Configuración del proyecto

Crear el proyecto de migración

El proyecto es el espacio permanente para claves, mapeos, configuración, ensayos, ejecuciones, auditoría y verificación. La barra de siete fases de la izquierda es también tu lista de control.

Haz esto

  1. 1

    Abrir Migrations

    En la barra lateral de MoveMRR, selecciona Migrations y después New migration. En una cuenta vacía, utiliza Create your first migration.

  2. 2

    Seleccionar el entorno

    Elige Sandbox para claves y datos de prueba o Live migration para producción. Esta elección controla la validación de claves, licencia, exención y los objetos Stripe que pueden modificarse; no es una etiqueta decorativa.

  3. 3

    Nombrar el proyecto

    Usa un nombre que identifique ambos lados, por ejemplo «Acme → BuyerCo · Producción». Añade la fecha de la operación o ventana de corte para que el historial de auditoría siga siendo comprensible.

  4. 4

    Crear el proyecto

    Selecciona Create migration. MoveMRR abre la primera fase incompleta. Ya no existe un modo Easy/Advanced: todos los proyectos siguen el mismo flujo, con acciones recomendadas primero y controles manuales disponibles cuando hagan falta.

Pantalla de MoveMRR del paso 2

Continúa solo cuando

  • La insignia del entorno muestra SANDBOX o LIVE según lo previsto.
  • El nombre identifica claramente la dirección de la migración.
  • La barra lateral muestra Connect, Catalog, Customers, Configure, Rehearse, Launch y Verify.
3 Fase 1 · Conectar

Generar, validar y guardar las dos claves Stripe

MoveMRR necesita leer el origen y crear objetos mapeados en el destino. Las claves restringidas limitan ese acceso a los permisos necesarios para esta migración.

Haz esto

  1. 1

    Empezar por la tarjeta Source

    Selecciona Generate. El diálogo crea un enlace directo a Stripe con permisos preseleccionados. Antes de abrirlo, confirma que la cuenta nombrada es la cuenta de origen del vendedor y que el modo Live o Test coincide con el proyecto.

  2. 2

    Crear y copiar la clave restringida en Stripe

    Abre el enlace, revisa permisos, crea la clave y cópiala inmediatamente. Stripe solo muestra una vez el secreto completo. Vuelve a MoveMRR, pégalo en Source y selecciona Validate & store.

  3. 3

    Repetir para Destination

    Repite el proceso desde la tarjeta Destination en la cuenta Stripe del comprador. La clave de destino necesita escritura porque MoveMRR crea productos, precios, cupones, suscripciones y, si se elige, endpoints de webhook.

  4. 4

    Resolver cuentas Stripe Connect cuando se solicite

    Si una clave pertenece a una plataforma Connect, elige la cuenta conectada propietaria de las suscripciones. «Acting as the platform account» significa que no se ha elegido ninguna. Vuelve a introducir la clave al aplicar una cuenta conectada porque los secretos guardados nunca regresan al navegador.

  5. 5

    Decidir si migrar endpoints de webhook

    Al activarlo, MoveMRR solicita permisos adicionales y recrea en destino los endpoints Stripe del origen durante el corte. Cada endpoint recibe un nuevo secreto whsec_ que debe desplegarse después de la ejecución.

Pantalla de MoveMRR del paso 3

Continúa solo cuando

  • Las dos tarjetas muestran Stored y Validated.
  • Los IDs mostrados coinciden con origen y destino previstos.
  • Ambas claves muestran el modo LIVE o TEST correcto.
  • Connect aparece completo en la barra de fases.

Atención

Nunca pegues una clave Live en un proyecto Sandbox ni una clave Test en un proyecto Live. Usa Generate en la tarjeta correcta en vez de adivinar permisos.

Conviene saberlo

Las claves se cifran en reposo y no vuelven al navegador tras guardarlas. El acceso caduca dentro de MoveMRR a los 30 días; Rotate reinicia ese plazo y el propietario debe revocar la clave en Stripe al terminar.

Referencia de claves Stripe restringidas →
4 Rama opcional · solo Sandbox

¿Tus sandboxes Stripe ya contienen datos realistas?

Un ensayo solo es útil si reproduce las formas de catálogo y suscripción de producción. El seeding queda fuera del camino principal porque muchos equipos ya mantienen sandboxes representativas.

Haz esto

  1. 1

    Si tus sandboxes están preparadas

    Omite el seeding y continúa directamente a Catálogo. «Preparada» significa que el origen contiene los productos, precios, cupones, clientes y suscripciones que quieres probar, y el destino se parece lo suficiente a la cuenta compradora para descubrir conflictos.

  2. 2

    Si alguna sandbox está vacía

    Abre el espacio Sandbox Seeding desde Connect. La guía separada cubre validación de claves Live en solo lectura, seeding de origen y destino, recuentos, selección de entidades, resultados, sincronización de clientes y CSV generado.

  3. 3

    Volver después de sincronizar clientes

    La guía de seeding vuelve aquí. Continúa a Catálogo; al llegar a Customers, usa el CSV generado por Customer sync en lugar de Stripe Customer Data Copy.

Pantalla de MoveMRR del paso 4

Continúa solo cuando

  • Las suscripciones de la sandbox de origen usan precios de origen realistas.
  • La sandbox de destino contiene el catálogo previo del comprador contra el que quieres probar.
  • Sabes si Customers utilizará el CSV de Stripe en Live o el CSV de Customer sync en Sandbox.
Abrir la guía completa de Sandbox Seeding →
5 Fase 2 · Catálogo

Mapear productos, precios, cupones y códigos promocionales

Las suscripciones apuntan a IDs de precio Stripe inmutables. Una suscripción de destino no puede usar el ID del origen, así que cada precio requerido debe resolverse antes del ensayo.

Haz esto

  1. 1

    Leer la barra de cobertura

    Products, Prices y Coupons muestran recuentos verificados de mapeados y requeridos. «Source total unknown» no significa cero: ejecuta el escaneo correspondiente. No continúes con un segmento requerido sin mapear o sin verificar.

  2. 2

    Ejecutar Migrate catalog automatically

    Selecciona la acción principal, revisa el plan y confirma. MoveMRR crea productos y precios activos faltantes, guarda mapeos y procesa cupones y códigos promocionales. Observa cada subpaso y revisa los resultados antes de cerrar.

  3. 3

    Revisar Products

    Confirma que los productos de destino representan los mismos planes o complementos. Un mapeo es una decisión de identidad: dos productos solo deben unirse cuando significan lo mismo para la facturación y la aplicación.

  4. 4

    Resolver Prices

    Abre Prices y filtra por Unmapped. Usa Auto-suggest solo después de comprobar importe, moneda, intervalo, tipo de uso, tramos y producto. Para catálogos grandes usa Bulk import; para el resto edita manualmente.

  5. 5

    Resolver cupones y códigos promocionales

    Abre Coupons, escanea el origen y crea o mapea los restantes. Ejecuta la cobertura de uso para no omitir un cupón aplicado a una suscripción que se migrará.

Pantalla de MoveMRR del paso 5

Continúa solo cuando

  • La cobertura requerida de productos y precios está completa.
  • Cada precio mapeado conserva significado comercial, moneda, importe e intervalo.
  • Los cupones usados por suscripciones migradas están cubiertos.
  • Se ha revisado cada resultado automático con estado skipped o failed.

Atención

No mapees solo por un nombre parecido. «Pro Monthly» puede diferir en moneda, importe, impuestos, tipo de uso o intervalo, y esas diferencias cambian lo que se cobra.

6 Fuera de MoveMRR · proyectos Live

Copiar clientes y datos de pago en Stripe

MoveMRR recrea suscripciones, no datos de tarjeta. Stripe Customer Data Copy transfiere de forma segura clientes y referencias de métodos reutilizables y genera el mapeo de IDs que MoveMRR necesita.

Haz esto

  1. 1

    Iniciar la copia en el origen

    En el Dashboard de origen abre Customers, selecciona Copy y luego Copy all customers. Introduce el ID de destino y envía la solicitud. Si la interfaz difiere, busca «Copy customers» sin salir de la cuenta de origen.

  2. 2

    Aceptar en el destino

    Cambia a la cuenta Stripe de destino. Abre Customers y acepta la solicitud entrante. Verifica que el aviso nombra el origen correcto antes de seleccionar Accept.

  3. 3

    Esperar a que Stripe termine

    No cargues un mapeo parcial o antiguo. Stripe procesa la transferencia de forma asíncrona; espera a que termine y esté disponible el documento Data Migrations.

  4. 4

    Descargar el CSV de mapeo

    En destino abre Settings → Compliance and documents → My documents. Busca el documento Data Migrations de este par exacto de cuentas y selecciona Download.

Continúa solo cuando

  • La solicitud de destino nombra la cuenta de origen correcta.
  • El número de clientes copiados es razonable para el alcance.
  • El CSV pertenece a esta transferencia y no a una anterior.

Atención

No abras y vuelvas a guardar el CSV con Excel, Numbers o Google Sheets. Pueden alterar IDs, comillas, codificación o caracteres iniciales. Carga el archivo original de Stripe.

Qué incluye Stripe Customer Data Copy →
7 Fase 3 · Clientes

Cargar y validar el mapeo de clientes

El mapeo une cada ID de cliente de origen con el cliente de destino creado por Stripe. Sin una fila válida, MoveMRR no puede asociar con seguridad la suscripción recreada ni el método de pago.

Haz esto

  1. 1

    Elegir la fuente correcta

    Para Live usa el CSV sin modificar descargado de Stripe. Para una Sandbox con seeding abre Customer sync; cuando termina genera y carga el mapeo automáticamente.

  2. 2

    Cargar el CSV

    En Customers selecciona o arrastra el archivo y espera a que termine Processing. MoveMRR valida estructura, IDs duplicados, valores y compatibilidad de cuentas antes de marcarlo Valid.

  3. 3

    Inspeccionar la carga seleccionada

    El espacio elige automáticamente la carga válida más reciente. Revisa filas e inválidos. Si cargas una corrección, confirma que el nuevo nombre está seleccionado antes del ensayo.

  4. 4

    Comprobar cobertura de métodos de pago

    Ejecuta el escaneo. Investiga ahora los clientes sin método predeterminado utilizable; de lo contrario su suscripción puede crearse sin la preparación necesaria para renovar.

Pantalla de MoveMRR del paso 7

Continúa solo cuando

  • Al menos una carga está marcada como Valid.
  • El recuento coincide con la población esperada.
  • La carga seleccionada es el archivo previsto.
  • Las carencias de método de pago están comprendidas o resueltas.

Atención

Nunca construyas el mapeo comparando correos electrónicos. No son únicos ni inmutables. Usa los IDs antiguos y nuevos generados por Stripe.

8 Fase 4 · Configurar

Revisar el comportamiento, especialmente la desactivación del origen

La configuración decide qué se crea, qué ocurre con las suscripciones del vendedor y cómo se tratan fechas, pruebas, metadatos y clientes con varias suscripciones. Los valores predeterminados son seguros, pero requieren revisión explícita.

Haz esto

  1. 1

    Confirmar Scope

    Mantén Migrate subscriptions para la migración principal. Migrate products controla el catálogo. Activa Migrate Stripe webhook endpoints solo si puedes desplegar los nuevos secretos whsec_ mostrados tras la ejecución.

  2. 2

    Elegir la desactivación del origen

    Cancel at period end es el valor predeterminado: el origen termina tras el periodo pagado y el destino conserva el calendario. Cancel immediately es un corte duro que rollback no reactiva automáticamente. Pause collection conserva la suscripción pero detiene el cobro. None exige desactivación manual y mantiene riesgo de doble cobro.

  3. 3

    Revisar Advanced settings

    El manejo atómico mueve todas las suscripciones de un cliente o ninguna. Decide si copiar todos, algunos o ningún metadato; conservar o acabar pruebas; y conservar, realinear o reiniciar ciclos. Preserve suele ser lo menos sorprendente.

  4. 4

    Guardar o confirmar valores

    Si cambiaste algo, usa la barra Save. Si los valores recomendados ya son correctos, selecciona Confirm defaults. La fase no termina hasta que MoveMRR registra la revisión.

Pantalla de MoveMRR del paso 8

Continúa solo cuando

  • El alcance contiene solo los objetos que quieres migrar.
  • La consecuencia en origen es aceptable para vendedor y comprador.
  • Ciclos y pruebas coinciden con lo prometido a clientes.
  • Configure aparece como reviewed en la barra.

Atención

Seleccionar None permite que ambas cuentas cobren a los mismos clientes hasta completar la lista de desactivación manual en Verify.

Cómo conservar fechas de renovación → Referencia para evitar doble facturación →
9 Fase 5 · Ensayar

Validar preparación, ejecutar dry run y simular

El ensayo separa «los datos parecen completos» de «este plan exacto se comporta como esperamos». Ninguna comprobación escribe suscripciones de producción.

Haz esto

  1. 1

    Seleccionar Validate readiness

    Readiness comprueba claves, catálogo, clientes, configuración y otros requisitos. Expande fallos, copia los IDs indicados, corrige la causa y vuelve a validar.

  2. 2

    Ejecutar un dry run

    El dry run crea el conjunto de acciones sin ejecutar la migración. Revisa creaciones, omisiones, desactivaciones, avisos y totales. Un número bajo suele señalar alcance o mapeos; uno alto, un CSV o cuenta incorrectos.

  3. 3

    Ejecutar la simulación

    La simulación prueba de forma controlada la creación de suscripciones y aproxima las respuestas de Stripe. Revisa cada categoría de fallo y vuelve a Catalog, Customers o Configure.

  4. 4

    Repetir después de cambios

    Cambiar configuración, mapeos, claves o CSV puede invalidar evidencias anteriores. Repite readiness y dry run tras cualquier cambio importante; no dependas de un resultado verde antiguo.

Pantalla de MoveMRR del paso 9

Continúa solo cuando

  • Readiness no contiene comprobaciones fallidas.
  • Los totales del dry run coinciden con la población esperada.
  • Los avisos están comprendidos y no solo ignorados.
  • El ensayo más reciente refleja mapeos, CSV y configuración actuales.

Atención

Un dry run es un plan, no una prueba de que toda escritura tendrá éxito. Usa dry run y simulación y mantén la ventana final libre de cambios.

10 Fase 6 · Ejecutar

Superar todas las puertas, confirmar y supervisar

Launch es la frontera controlada de producción. La lista evita empezar sin evidencias, la confirmación muestra el alcance y la tarjeta de ejecución sigue siendo la fuente de verdad hasta el estado final.

Haz esto

  1. 1

    Completar la lista de puertas

    Resuelve cada bloqueo: claves, catálogo, clientes, revisión de configuración, readiness reciente, licencia y, para Live, exención de responsabilidad. Sandbox no requiere licencia ni exención.

  2. 2

    Decidir sobre suscripciones past-due

    La inclusión se elige por ejecución y está desactivada por defecto porque la factura abierta de origen se anula y el cobro reinicia en el siguiente ciclo. Inclúyelas solo con acuerdo contable de comprador y vendedor.

  3. 3

    Empezar ahora o programar

    Start migration abre la confirmación final. Revisa clientes, precios, entorno, desactivación, dry run y past-due. Una ejecución programada exige confirmar a la hora prevista; mantén disponible una persona autorizada.

  4. 4

    Supervisar la ejecución Live

    Mantén abierta la consola. Progreso, limitación de Stripe, fallos y acciones seguras aparecen en la tarjeta. Pause es el freno seguro; no canceles suscripciones ni edites mapeos mientras esté activa.

  5. 5

    Reconocer el resultado final

    Al terminar, lee el resultado y abre el detalle de fallos. Reconocerlo elimina la alerta de la barra; no borra la ejecución ni su historial.

Pantalla de MoveMRR del paso 10

Continúa solo cuando

  • Todas las puertas de Launch están verdes antes de confirmar.
  • Los recuentos finales y el entorno son correctos.
  • Una persona puede supervisar hasta el estado final.
  • Nadie editará manualmente suscripciones de origen durante la ejecución.

Atención

No inicies una segunda ejecución para «desatascar» otra activa. Usa Pause o la acción explícita de reintento cuando la actual alcance un estado final.

11 Fase 7 · Verificar

Conciliar las dos cuentas y completar el corte

Una ejecución terminada no acaba la migración. Verify convierte resultados en entrega operativa: resolver fallos, conciliar origen y destino, desplegar secretos y confirmar que las renovaciones llegan al comprador.

Haz esto

  1. 1

    Leer el resultado y la Action queue

    Empieza por la última ejecución Live. Completa seguimientos del servidor: reintentos, limpieza, acciones programadas, corrección de métodos o rollback cuando esté disponible. Exporta el mapa de IDs y la lista de desactivación manual.

  2. 2

    Generar Reconciliation

    Compara suscripciones, clientes, MRR por moneda y, si se eligieron, endpoints de webhook. Investiga huérfanos y diferencias. El MRR se muestra por moneda y no debe sumarse entre monedas.

  3. 3

    Corregir métodos predeterminados

    Vuelve a escanear y usa la acción correctiva para clientes cuyo método migrado existe pero no es el predeterminado. Exporta las excepciones restantes.

  4. 4

    Desplegar el corte de la aplicación

    Sustituye claves secretas y públicas de destino, actualiza IDs de productos/precios, cambia referencias de Customer Portal y Connect y despliega cada nuevo secreto whsec_ antes de confiar en endpoints recreados.

  5. 5

    Supervisar renovaciones reales

    Observa la primera cohorte en destino, confirma la desactivación del origen y monitoriza webhooks, pagos fallidos, soporte y MRR. Conserva proyecto y exportaciones como registro.

Pantalla de MoveMRR del paso 11

Continúa solo cuando

  • La Action queue no contiene seguimientos pendientes derivados del servidor.
  • La conciliación funciona o cada diferencia tiene responsable y explicación escrita.
  • Claves, precios, portales y secretos webhook apuntan al destino.
  • Una muestra de próximas renovaciones ha tenido éxito en destino.

Atención

No elimines ni archives inmediatamente el origen. Mantenlo accesible durante la ventana acordada para revisar facturas, cancelaciones, disputas y evidencias.

Entrega final

La migración termina cuando coinciden las evidencias

Un estado verde no basta. Considera terminada la migración solo cuando los resultados, la cola de acciones, la conciliación, la configuración de destino, los webhooks y las renovaciones reales cuentan la misma historia.

Preguntas frecuentes

¿Debo elegir todavía Easy o Advanced Mode?

No. Esa división se eliminó. Todas las migraciones usan el mismo proceso de siete fases. Las acciones recomendadas aparecen primero y los mapeos manuales y la configuración avanzada siguen disponibles.

¿Es obligatorio Sandbox Seeding?

No. Omítelo si tus sandboxes ya tienen datos representativos. Úsalo cuando un entorno vacío haría inútil el ensayo. Solo está disponible en proyectos Sandbox de MoveMRR.

¿Puede MoveMRR copiar datos de tarjeta?

Ninguna aplicación debe manejar números de tarjeta sin procesar. En Live, Stripe Customer Data Copy transfiere clientes y referencias de métodos reutilizables. En Sandbox, Customer sync crea clientes con métodos de prueba.

¿Qué hago tras cambiar un mapeo o la configuración?

Vuelve a Rehearse, valida readiness y crea un dry run nuevo. Las evidencias de Launch deben describir claves, CSV, mapeos y configuración actuales, no una versión anterior.

¿Cuándo está realmente terminada la migración?

Cuando la ejecución ha terminado, la cola de Verify está vacía, la conciliación está aceptada, claves y secretos webhook están desplegados y las primeras renovaciones reales funcionan en destino.

Abre MoveMRR y mantén esta guía a tu lado

La barra de fases indica dónde estás. Esta guía explica por qué importa cada decisión antes de tomarla.

Abrir MoveMRR →