Solicita la importación de datos de pago

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

1. Desde tu sitio web que se ejecuta en el navegador del cliente, Stripe recopila de forma segura sus datos de pago.
2. Stripe responde con un token representativo.
3. El navegador envía el token a tu servidor, junto con cualquier otro dato del formulario.
4. Tu código del lado del servidor usa ese token en una solicitud de 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 en cumplimiento de la normativa PCI, lo que puede ahorrarte tiempo y proporcionarte beneficios financieros.

Flujo del proceso de pago de Stripe

En comparación con otros procesadores de pagos, la integración con Stripe difiere de las siguientes maneras:

• Tu cliente nunca deja tu sitio web.
• La creación del token no está vinculada a un producto o importe específico.
• No es necesario crear una clave del lado del cliente a pedido. En cambio, usa una clave de API publicable establecida.

Prepara tu integración

Para todos los tókenes de clientes nuevos (no importados), implementa lo siguiente:

• Usa objetos Customer para guardar la información de tarjeta.
• Recopila y tokeniza los datos de tarjeta del cliente con una de nuestras integraciones de pago recomendadas.
• Crea cargos para estos nuevos clientes.

Con este enfoque, puedes aceptar pagos de tus nuevos clientes en Stripe sin afectar a tus clientes actuales en tu encargado del tratamiento actual durante el proceso de migración.

Consideraciones de integración

Diseñar tu integración antes de pedirle a tu procesador de pagos que transfiera datos a Stripe es la forma más eficiente de gestionar los datos importados. Algunas de las acciones que puedes realizar antes de solicitar una importación incluyen:

• Completa la configuración de tu cuenta de Stripe.
• Reasignar los registros de clientes.
• Manejar actualizaciones de los datos de pago durante la migración.
• Habilita todas las optimizaciones, como Adaptive Acceptance, actualizador de tarjetas (CAU) y tókenes de red.

Cómo reasignar registros de clientes

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. Hacerlo evita que la migración cree un nuevo cliente (posiblemente duplicado) en tu cuenta de Stripe para cada ID de cliente único en los archivos que recibimos de tu encargado del tratamiento anterior.

Después de la migración, es posible que aún tengas que actualizar algunos registros para que se correspondan con el nuevo identificador Customer de Stripe si se cumple con lo siguiente:

• Creaste el cliente de Stripe antes de la migración y luego importamos la información de pago para actualizar el registro del cliente.
• Importamos la información de pago como un registro de cliente nuevo.

Por ejemplo, el cliente carmen.rodriguez@example.com puede tener el ID 42 en tu base de datos, correspondiente al ID 1893 en el sistema de tu encargado del tratamiento anterior, pero es el ID cus_12345 en tu cuenta de Stripe. En este caso, ahora debes asignar tu ID 42 al ID de Stripe cus_12345 en tu base de datos. Stripe proporciona un archivo de asignación posterior a la importación para ayudarte a identificar las reasignaciones necesarias.

Cómo gestionar actualizaciones de la información de pago

Si los clientes actualizan su información de pago con tu encargado del tratamiento anterior en el intervalo entre la transferencia de los datos y la finalización de la importación, esos cambios se pierden.

Actualiza el proceso de tu sitio para gestionar las actualizaciones de los pagos guardados a fin de evitar errores o problemas de gestión de cobros a tus clientes. Esto implica preparar el sistema para hacer la automigración de cualquier cliente sin un ID de cliente de Stripe almacenado:

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

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

1. Una vez que hayas completado la integración y tengas todo listo para procesar pagos en Stripe, solicita los datos de pago a tu encargado del tratamiento anterior. Muchos encargados del tratamiento requieren que el titular de la cuenta solicite una transferencia de datos.
2. Inicia sesión en tu cuenta de Stripe para enviar el formulario de solicitud de migración para solicitar la migración de importación.
3. Interactúa con Stripe a través del hilo de correos electrónicos autenticado que creamos después de recibir tu solicitud de migración.

Stripe puede importar la información de la dirección de pagos y los detalles de pago de tus clientes. Para obtener más información sobre la migración de tipos de pago específicos, consulta:

• Tarjetas
• ACH
• SEPA
• Bacs
• PAD/ACSS

Las migraciones de datos no migran las suscripciones, pero puedes recrearlas por separado o importarlas usando el conjunto de herramientas de migración de Billing.

Tu encargado del tratamiento anterior puede tardar algunos días o varias semanas en transferir los datos finales a Stripe. Ten en cuenta este período de transición en tu plan de migración.

Después de que tu encargado del tratamiento anterior transfiere los datos, Stripe los revisa e identifica cualquier problema con la importación. Trabajaremos contigo y con tu encargado del tratamiento anterior para corregir cualquier problema. A continuación, compartimos un resumen de la importación para su revisión y aprobación final.

Después de tu aprobación, Stripe importa los datos a tu cuenta. Creamos un objeto Customer para cada cliente único en el archivo de datos transferidos, 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 tomaremos como el método de pago predeterminado del cliente para los cargos y los pagos de suscripciones.

Si tu cuenta de Stripe acumuló registros de clientes importantes para el momento de la migración, considera la posibilidad de asignar la fecha de importación a los objetos Customer de Stripe existentes en lugar de crear nuevos objetos Customer.

Por lo general, Stripe importa los datos en un plazo de 10 días hábiles después de recibir los datos correctos de tu encargado del tratamiento anterior, junto con los archivos de datos complementarios que desees compartir con nuestro equipo.

Después de completar la importación, Stripe te envía un archivo CSV o JSON que muestra la relación asignada entre los ID de tu encargado del tratamiento actual y los ID de los objetos de Stripe importados. Analiza este archivo de asignación y actualiza tu base de datos en consecuencia. Asegúrate de que tu integración gestione las actualizaciones de tarjetas que tuvieron lugar durante la transición.

Archivo de asignación posterior a la importación

Después de actualizar la integración con este archivo de asignaciones, podrás comenzar a cobrar a todos los 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 JSON anterior muestra lo siguiente:

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

Stripe puede importar datos de tarjetas como PaymentMethod en lugar de objetos Card si así 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

Rechazos de pagos posteriores a la importación

Después de la migración, controla el rendimiento de tus pagos para asegurarte de que la tasa de aceptación de los datos de pago importados coincida con tus expectativas.

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

Tanto en tu enfoque general como en el período posterior a la migración, alinea tus metas de optimización de autorizaciones de pagos con los objetivos de tu empresa. Por ejemplo, una empresa de bienes digitales con bajo costo por unidad podría establecer su nivel de riesgo para bloquear menos pagos. Considera los posibles efectos:

• Aumento de las tasas de conversión debido a menos fricciones.
• Mayor exposición al fraude debido al procesamiento de los pagos más riesgosos.
• Tasas de autorización del emisor sin procesar más bajas debido a los bloqueos del modelo de fraude por parte del emisor.

Asegúrate de facilitar datos precisos (como el nombre del titular de tarjeta, la dirección de pagos y el correo electrónico). Reflejar el intent del titular de tarjeta maximiza el potencial de autorización exitosa.

Identifica las tarjetas registradas en el archivo

Las migraciones de datos de pago implican cards on file (tarjetas guardadas para pagos futuros iniciados por el comerciante o fuera de la sesión para el mismo cliente). Asegúrate de almacenar los datos de pago importados y de etiquetar los pagos con esas tarjetas registradas en el archivo con el parámetro off_session correcto. Si identificas incorrectamente las tarjetas registradas:

• Los emisores que no puedan confirmar el consentimiento del titular de una tarjeta para pagos futuros o recurrentes pueden 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 tókenes de red (NT).

Supervisa los motivos de rechazo para las oportunidades de optimización

Después de la migración, los motivos del rechazo del emisor pueden ayudarte a identificar si los datos de pago migrados están realizando transacciones como se esperaba. Los picos en ciertos tipos de rechazos pueden beneficiarse de los siguientes productos de optimización:

• Actualizador de tarjetas: La colaboración de Stripe con las redes de tarjetas nos permite obtener automáticamente actualizaciones de las tarjetas vencidas o reemplazadas tanto en tiempo real como en segundo plano.
• Automatic retries (Dunning): Use caution because retrying numerous cards (such as after a migration) can appear suspicious to issuers. If you use Stripe’s Smart retries for your billing payments, our AI model analyzes decline code, payment method updates, and bank risk threshold activity to retry recurring revenue payments more strategically.
• Tókenes de red: Reemplaza un número de cuenta de pago (PAN) específico con 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 uses AI to assess the effect of minor adjustments (such as formatting) to an authorization request in real-time, then refines the payment retry before returning the original decline to the customer.
• Alcance al cliente: pedirle a tu cliente que inicie sesión y vuelva a introducir o verificar sus datos de pago a menudo restablece la confiabilidad de tu empresa con el cliente y los proveedores de pago. Considera la posibilidad de 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 una variedad de motivos de rechazo.

Si no conoces PGP, consulta GPG y empieza importando una clave pública. Después de familiarizarte con los conceptos básicos de PGP, usa la siguiente clave PGP para cifrar datos confidenciales (como la información de tarjetas de crédito) para una migración conforme a la normativa PCI.

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

• ID de la clave: 9C78B7620C1E99AD
• Tipo de clave: RSA
• Tamaño de la clave: 4096 bits
• Huella: 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 la línea de comandos:

gpg --encrypt --recipient 9C78B7620C1E99AD FILENAME

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