Solicita la importación de datos de pago

Importa los datos de pago confidenciales de forma segura.

Stripe te permite conservar tus datos de clientes y pagos existentes cuando migras a Stripe. Trabajamos con tu equipo y tu proveedor de pagos actual, según sea necesario, para migrar tu información de forma segura.

Este proceso te permite aceptar y cobrar a nuevos clientes en Stripe y, al mismo tiempo, seguir cobrando a tus clientes actuales con tu procesador actual hasta que se complete la migración. Tus clientes no experimentarán tiempo de inactividad. Una vez completado el proceso de migración, puedes procesar todos los pagos en Stripe.

Esta guía te enseña cómo migrar a Stripe desde otro procesador de pagos o una solución de pago personalizada si eres una empresa no empresarial (como una startup o una pequeña empresa). También crearás una integración de Stripe que podrás probar antes de ponerla en marcha. Si tienes alguna pregunta sobre el proceso de migración o la integración con Stripe, consulta las sección de soporte. Si aún no lo has hecho, revisa las tarifas de Stripe.

Cosas a tener en cuenta

Las empresas deben solicitar asistencia al equipo de migraciones de datos de Stripeantes de realizar la migración.
Si tienes que transferir información confidencial sobre pagos, debes completar una solicitud de migración de datos antes de realizar la migración. Podemos ayudarte a hacerlo de forma segura y conforme con la normativa PCI.

Revisar las funciones de integración de Stripe

Stripe simplifica tus requisitos de seguridad para que tus clientes no tengan que salir de tu sitio web para completar un pago. Esto se hace mediante una combinación de pasos del lado del cliente y del lado del servidor:

Desde tu página web que se ejecuta en el navegador del cliente, Stripe recopila de forma segura sus datos de pago.
Stripe responde con un token representativo.
El navegador envía el token a tu servidor, junto con cualquier otro dato del formulario.
Tu código del lado del servidor utiliza ese token en una petición a la API (por ejemplo, al crear un cargo).

Este enfoque agiliza el flujo de compra de tu sitio web, y la información de pago confidencial nunca entra en contacto con tu servidor. Esto te permite operar de acuerdo con las normativas de cumplimiento de PCI, lo que puede ahorrarte tiempo y proporcionarte beneficios financieros.

Flujo del proceso de pago de Stripe

En comparación con otros procesadores de pago, la integración de Stripe puede variar de las siguientes maneras:

Tu cliente nunca abandona tu sitio web.
La creación del token no está vinculada a ningún producto o importe concreto.
No es necesario crear una clave en el lado del cliente bajo demanda. En su lugar, utiliza una clave de API publicable y establecida.

Crea una cuenta de Stripe

Antes de integrarte con Stripe, debes crear una cuenta de Stripe.

Crea una cuenta introduciendo tu dirección de correo electrónico, nombre completo, país y creando una contraseña.
Rellena tu perfil empresarial.
En el Dashboard, haz clic en Verificar tu correo electrónico. Stripe enviará un correo electrónico de verificación a tu dirección de correo electrónico.
Verifica tu dirección de correo electrónico

Crea una integración con Stripe

Para todos los tokens de clientes nuevos (no importados), implementa lo siguiente:

Utiliza objetos Customer para guardar la información de la tarjeta.
Recopila y tokeniza la información de las tarjetas de los clientes con una de nuestras integraciones Payments recomendadas. Crea tu integración con Stripe antes de solicitar a tu procesador de pagos que transfiera los datos a Stripe. Para la mayoría de las empresas emergentes, recomendamos crear una integración de pago integrado un formulario de pago que se incrusta en tu sitio web.
Para configurar esta integración, consulta el proceso de compra integrado QuickStart y acepta pagos únicos y pagos por suscripción (si procede).
Crear cargo para estos nuevos clientes.

Con este enfoque, puedes aceptar pagos de tus nuevos clientes en Stripe sin que tus clientes actuales se vean afectados en tu procesador existente durante el proceso de migración.

Aspectos que debes tener en cuenta sobre la integración

La forma más eficiente de gestionar los datos importados es diseñar tu integración antes de pedir a tu procesador de pagos que transfiera los datos a Stripe. Estas son algunas de las acciones que puedes realizar antes de solicitar una importación:

Reasigna registros de clientes
Protege las actualizaciones de los métodos de pago guardados durante la migración.
Habilita todas las optimizaciones, como la aceptación adaptativa, el actualizador de cuentas de tarjetas (CAU) y los tokens de red.

OpcionalAsignar clientes a ID de Stripe

Si lo prefieres, puedes configurar tu integración para importar los datos del método de pago de registros anteriores a los objetos Customer existentes de Stripe. De este modo, se evita que la migración cree un nuevo Customer (posiblemente duplicado) en tu cuenta de Stripe para cada ID de cliente único en los archivos que recibimos de tu procesador anterior.

Después de la migración, es posible que aún tengas que actualizar algunos registros para que coincidan con el nuevo identificador de Customer de Stripe, si se dan los siguientes casos:

Has creado el Customer de Stripe antes de la migración, y luego hemos importado la información de pago para actualizar este registro de Customer.
Importamos la información de pago como un nuevo registro de Customer.

Por ejemplo, es posible que el cliente carmen.garcia@example.com tenga el ID 42 en tu base de datos, correspondiente al ID 1893 del sistema de tu anterior procesador, pero que tenga el ID cus_12345 en tu cuenta de Stripe. En este caso, ahora debes asignar tu ID 42 al ID de Stripe cus_12345 de tu base de datos. Stripe proporciona un archivo de asignación posterior a la importación para ayudarte a identificar la reasignación necesaria.

OpcionalProtege las actualizaciones de los métodos de pago guardados.

Si los clientes actualizan su información de pago con tu anterior procesador en el intervalo entre la transferencia de los datos y la importación, esos cambios se perderán.

Actualiza el proceso de tu sitio para gestionar las actualizaciones de los pagos guardados y evitar errores o problemas de facturación a tus clientes. Esto incluye preparativos para realizar una automigración para cualquier cliente que no tenga un ID de Customer de Stripe almacenado:

Crea un nuevo objeto Customer en Stripe para tu cliente.
Asocia el método de pago al objeto Customer.
Si es necesario, migra las suscripciones.

Una vez completada la migración, Stripe gestiona automáticamente las actualizaciones activadas por las tarjetas, como los cambios de fecha de caducidad.

Prueba tu integración con Stripe

Para probar la integración de tu formulario de pago integrado:

Crea una sesión de pago integrado e instala el formulario de pago en tu página.
Rellena los datos de pago con un método de la tabla siguiente.
- Introduce cualquier fecha futura como fecha de caducidad.
- Introduce cualquier número de 3 dígitos como CVC.
- Introduce cualquier código postal de facturación.
Haz clic en Pagar. Se te redireccionará a tu return_url.
Ve al Dashboard y busca el pago en la página Transacciones. Si el pago se ha realizado correctamente, lo verás en esa lista.
Haz clic en tu pago para ver más detalles, como un resumen de Checkout con la información de facturación y la lista de artículos comprados. Puedes usar esta información para completar el pedido.

Más información sobre cómo probar tu integración.

Número de tarjeta	Situación	Cómo hacer pruebas
	El pago con tarjeta se realiza correctamente y no requiere autenticación.	Rellena el formulario de tarjeta de crédito con el número de tarjeta y cualquier fecha de caducidad, CVC y código postal.
	El pago con tarjeta requiere autenticación.	Rellena el formulario de tarjeta de crédito con el número de tarjeta y cualquier fecha de caducidad, CVC y código postal.
	La tarjeta se rechaza con un código de rechazo como, por ejemplo, `insufficient_funds`.	Rellena el formulario de tarjeta de crédito con el número de tarjeta y cualquier fecha de caducidad, CVC y código postal.
	La tarjeta UnionPay tiene una longitud variable de 13-19 dígitos.	Rellena el formulario de tarjeta de crédito con el número de tarjeta y cualquier fecha de caducidad, CVC y código postal.

Consulta Pruebas para obtener información adicional para probar tu integración.

Solicita y confirma los detalles de la migración

Cuando hayas completado la integración y estés listo para procesar pagos en Stripe, solicita los datos de pago a tu anterior procesador. Muchos procesadores requieren que el propietario de la cuenta solicite una transferencia de datos.
Inicia sesión en tu cuenta de Stripe para enviar el formulario de solicitud de migración y solicitar la importación de tus datos.
Habla con Stripe a través del hilo de correo electrónico autenticado que creamos al recibir tu solicitud de migración.

Advertencia

Nunca envíes datos confidenciales de tarjetas de crédito o información del cliente directamente a Stripe. Si tienes estos datos, indícanoslo en tu formulario de solicitud de migración para que podamos ayudarte a transferir los datos de manera segura.

Stripe puede importar la información de la dirección de facturación y los datos de pago de tus clientes. También puedes:

Migra tipos de pago específicos
Migra suscripciones o impórtalas con el Kit de herramientas para la migración de facturación.

Tu procesador anterior podría tardar unos días o varias semanas en transferir los datos finales a Stripe. Ten en cuenta este tiempo de transición en tu plan de migración. Una vez que tu procesador anterior haya transferido tus datos, Stripe los revisará e identificará cualquier problema con la importación. Trabajaremos contigo y con tu procesador anterior para corregir cualquier problema. A continuación, te enviaremos un resumen de la importación para que lo revises y apruebes definitivamente.

Tras tu aprobación, Stripe importa los datos a tu cuenta. Creamos un Customer para cada cliente único en el archivo de datos transferido, y creamos y adjuntamos las tarjetas del cliente como objetos Card o Payment Method. Si los datos transferidos especifican la tarjeta predeterminada del cliente, la establecemos como el método de pago predeterminado del cliente para los cargos y los pagos de suscripciones.

Si tu cuenta de Stripe ha acumulado un número significativo de registros de clientes en el momento de la migración, considera la posibilidad de asignar los datos de importación a los objetos de cliente existentes en Stripe en vez de crear nuevos objetos Customer.

Stripe normalmente importa los datos en un plazo de 10 días hábiles después de recibir los datos correctos de tu anterior procesador, junto con cualquier archivo de datos complementario que desees compartir con nuestro equipo.

Actualiza tu integración

Después de completar la importación, Stripe te envía la opción de un archivo CSV o JSON que muestra la relación asignada entre los ID de tu procesador actual y los ID de objetos de Stripe importados. Analiza este archivo de asignación y actualiza tu base de datos según corresponda. Asegúrate de que tu integración haya gestionado todas las actualizaciones de tarjetas que hayan tenido lugar durante la transición.

Archivo de asignación posterior a la importación

Después de actualizar tu integración con este archivo de asignación, podrás empezar a cargar a todos tus clientes en Stripe.

{
  "1893": {
    "cards": {
      "2600": {
        "id": "card_2222222222",
        "fingerprint": "x9yW1WE4nLvl6zjg",
        "last4": "4242",
        "exp_month": 1,
        "exp_year": 2020,
        "brand": "Visa"
      },
      "3520": {
        "id": "card_3333333333",
        "fingerprint": "nZnMWbJBurX3VHIN",
        "last4": "0341",
        "exp_month": 6,
        "exp_year": 2021,
        "brand": "Mastercard"
      }
    },
    "id": "cus_abc123def456"
  }
}

El ejemplo de asignación de JSON anterior muestra lo siguiente:

Se importó el ID de cliente 1893 como un nuevo Customer de Stripe con el ID cus_abc123def456.
Se importó la tarjeta de cliente con ID 2600 como una nueva Card de Stripe con ID card_2222222222.
Se importó la tarjeta de cliente con ID 3520 como una nueva Card de Stripe con ID card_3333333333.

Stripe puede importar datos de tarjetas como PaymentMethods en vez de objetos Card si lo especificas en tu solicitud de migración. Los siguientes ejemplos muestran los archivos de asignación para diferentes tipos de importaciones de información de pago.

old_customer_id,customer_id,old_card_id,card_id,card_fingerprint,card_last4,card_exp_month,card_exp_year,card_brand
old_cus_100,cus_abc123def456,old_src_100,card_2222222222,x9yW1WE4nLvl6zjg,424242,09,2024,Visa

Supervisa tus pagos importados.

Después de la migración, supervisa el rendimiento de tus pagos para asegurarte de que la tasa de aceptación de los datos de pago importados se ajuste a tus expectativas.

La aceptación del pago (o tasa de autorización del emisor) es el porcentaje de transacciones que los emisores autorizan con éxito de todas las transacciones enviadas para el pago. Esta métrica excluye las transacciones bloqueadas (por ejemplo, debido a las reglas de Radar) porque estas nunca se envían para su autorización.

Tanto en tu enfoque general como después de la migración, alinea tus metas de optimización de la autorización de pagos con tus objetivos comerciales. Por ejemplo, una empresa de artículos digitales con un coste unitario bajo podría establecer su nivel de riesgo para bloquear menos pagos. Ten en cuenta los posibles efectos:

Aumento de las tasas de conversión debido a la menor fricción.
Mayor exposición al fraude debido a que los pagos de mayor riesgo se tramitan.
Menores tasas de autorización sin procesar del emisor debido a los bloqueos del modelo de fraude por parte del emisor.

Asegúrate de proporcionar datos precisos (como el nombre del titular de la tarjeta, la dirección de facturación y el correo electrónico). Reflejar la intención del titular de la tarjeta maximiza las posibilidades de que la autorización se realice con éxito.

Identifica las tarjetas registradas

Las migraciones de datos de pago afectan a las tarjetas registradas (tarjetas guardadas para un pago futuro iniciado por el comerciante o fuera de la sesión para el mismo cliente). Asegúrate de que almacenas los datos de pago importados y etiquetas los pagos con esas tarjetas registradas con el parámetro off_session correcto. Si identificas incorrectamente las tarjetas registradas:

Los emisores que no puedan confirmar el consentimiento del titular de la tarjeta para pagos futuros o recurrentes podrían rechazarlos.
Es posible que los datos de pago no cumplan con los requisitos para ciertos productos de optimización de Stripe, como el actualizador de tarjetas (CAU) y los tokens de red (NT).

Monitorea los motivos de rechazo en busca de oportunidades de optimización

Tras tu migración, los motivos de rechazo del emisor pueden ayudarte a identificar si los datos de pago migrados se están procesando como esperabas. Los picos en ciertos tipos de rechazos pueden beneficiarse de los siguientes productos de optimización:

Actualizador de tarjetas: las asociaciones de Stripe con redes de tarjetas permiten obtener actualizaciones automáticas de tarjetas caducadas o reemplazadas, tanto en tiempo real como en segundo plano.
Reintentos automáticos (reclamación del pago): ten cuidado porque los emisores pueden considerar sospechoso el reintento de varias tarjetas (por ejemplo, después de una migración). Si usas Smart Retries de Stripe para tus pagos de facturación, nuestro modelo de IA analiza el código de rechazo, las actualizaciones de los métodos de pago y la actividad del umbral de riesgo bancario para reintentar los pagos de ingresos recurrentes de forma más estratégica.
Tokens de red: Reemplaza un número de cuenta de pago (PAN) específico por un token seguro de la red de tarjetas para asegurarte de que las actualizaciones del PAN (como la renovación o el reemplazo) se reflejen automáticamente en el token.
Adaptive acceptance: Stripe usa IA para evaluar el efecto de pequeños ajustes (como el formato) en una solicitud de autorización en tiempo real, y luego perfecciona el reintento de pago antes de devolverle el rechazo original al cliente.
Contacto con el cliente: pedir al cliente que inicie sesión y vuelva a ingresar o verificar sus datos de pago suele restablecer la confianza en tu empresa, tanto por parte del cliente como de los proveedores de pago. Considera notificar a los clientes a través de canales distintos del correo electrónico, como mensajes de texto o notificaciones en la aplicación.

En la tabla siguiente se muestran los productos de optimización que ofrecen mejoras para diversos motivos de rechazo.

Los códigos de rechazo pueden incluir	Efecto de la migración	Lo que debes hacer	Lo que no debes hacer
`incorrect_number` `invalid_number` `expired_card`	Las actualizaciones de los datos de la tarjeta durante el retraso natural de la migración pueden hacer que los datos de la tarjeta guardados estén desactualizados.	Actualizador de cuentas de tarjeta Tokens de red Adaptive Acceptance Contacta con el cliente	Reintentar
`generic_decline` `do_not_honor`	Los cambios en la descripción del cargo en el extracto bancario u otros marcadores de identificación pueden activar modelos de riesgo para el emisor o confundir al cliente.	Reintentar Tokens de red Adaptive Acceptance Contacta con el cliente	Actualizador de cuentas de tarjeta
`transaction_not_allowed` `try_again_later` `authentication_required` `incorrect_cvc`	Es posible que a algunos datos de pago migrados les falten los datos iniciales de validación de la tarjeta, como el token de red o el ID de la transacción original.	Actualizador de cuentas de tarjeta Reintentar Adaptive Acceptance Contacta con el cliente	Tokens de red
`lost_card` `stolen_card` `invalid_account` `pickup_card` `card_not_supported`	Los clientes pueden denunciar la pérdida o el robo de tarjetas durante un retraso en la migración. Estate atento a un evento especial de CONTAC junto con estos rechazos.	Tokens de red Contacta con el cliente	CAU Reintentar¹ Adaptive Acceptance

¹ Reintentar datos de pago perdidos o robados puede parecer sospechoso para los emisores de tarjetas.

OpcionalMigra las suscripciones

Las migraciones en las que hay suscripciones suelen incluir estas etapas:

Configura tu integración de facturación.
Migra la información de tus clientes y procesadores de pagos.
Importa tus suscripciones a Stripe Billing.
Puedes importar suscripciones existentes utilizando la API de suscripciones o el kit de herramientas de migración facturación del Dashboard.
Después de dejar tu procesador de pagos, confirma que haya cancelado toda la facturación automática de tus clientes.

Clave PGP para migración

Si no estás familiarizado con el PGP, consulta GPG y empieza por importar una clave pública. Una vez que te familiarices con los conceptos básicos de PGP, usa la siguiente clave de PGP para cifrar datos confidenciales (como la información de la tarjeta de crédito) para la migración conforme a la normativa PCI.

Clave de migración PGP

Esto crea FILENAME.gpg con la siguiente información:

ID de clave: 9C78B7620C1E99AD
Tipo de clave: RSA
Tamaño de clave: 4096 bits
Huella dactilar: AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD
ID de usuario: Stripe Import Key (PCI) <support-migrations@stripe.com>

Después de importar nuestra clave, puedes cifrar los archivos para enviarlos ejecutando este comando en tu línea de comandos:

gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME

Para obtener más información sobre cómo proporcionar datos cifrados a Stripe, consulta Cargar datos complementarios.