Aplicaciones relacionadas con pagos de Shopify: Atención: la migración a mTLS debe completarse antes del 15 de octubre
El 16 de julio, Shopify publicó un cambio relacionado con la seguridad de los datos de pago en el registro de actualizaciones para desarrolladores: las aplicaciones que almacenan datos de titulares de tarjetas en Shopify de una manera específica deben completar la migración a mTLS antes del 15 de octubre de 2026.
Este cambio no se aplica a todas las aplicaciones de Shopify, ni todas las aplicaciones de pago se verán afectadas. Más precisamente, afecta a las aplicaciones que envían datos originales de titulares de tarjetas de crédito al endpoint de depósito de tarjetas de Shopify.
Si tu equipo mantiene aplicaciones de pago de Shopify, herramientas de migración de suscripciones, herramientas de importación de métodos de pago, o proporciona desarrollo personalizado para marcas DTC, este cambio merece ser revisado lo antes posible.
¿Cuáles son los requisitos específicos de Shopify?
Según el changelog oficial de Shopify, el endpoint de depósito de tarjetas de Shopify ahora requiere que las solicitudes incluyan un certificado de cliente mTLS emitido por Shopify.
El endpoint involucrado es: https://checkout-mtls.pci.shopifyinc.com/sessions
Este endpoint en sí no ha cambiado, la modificación radica en que, en el futuro, cada solicitud que envíe datos de titulares de tarjetas a él debe incluir un certificado de cliente mTLS emitido por Shopify.
Shopify ha establecido el 15 de octubre de 2026 como fecha límite para la migración. Una vez que se inicie la ejecución, si la solicitud no tiene un certificado válido, las solicitudes de depósito relacionadas serán rechazadas. Las aplicaciones que no completen la migración no podrán seguir depositando nuevos datos de titulares de tarjetas en Shopify.
¿Qué API / aplicaciones se verán afectadas?
Las aplicaciones que se verán afectadas son aquellas que envían datos de titulares de tarjetas a través del endpoint de depósito de tarjetas de Shopify y luego llaman a las siguientes mutaciones de la API de administración de GraphQL:
- customerPaymentMethodCreditCardCreate
- customerPaymentMethodCreditCardUpdate
Ambas mutaciones dependen de sessionId. Este sessionId proviene de que la aplicación envía primero los datos de la tarjeta al endpoint de depósito de tarjetas /sessions de Shopify.
El flujo típico se puede entender como: la aplicación procesa datos de tarjetas originales en un entorno compatible con PCI; envía los datos de la tarjeta al endpoint /sessions de Shopify; Shopify devuelve un identificador de sesión; la aplicación luego llama a customerPaymentMethodCreditCardCreate o customerPaymentMethodCreditCardUpdate, pasando ese identificador de sesión a Shopify.
Este tipo de escenarios suelen aparecer en negocios como guardar tarjetas, actualizar tarjetas, migración de métodos de pago de suscripciones, y almacenamiento de métodos de pago de clientes.
¿Qué aplicaciones no se verán afectadas?
Shopify ha aclarado que customerPaymentMethodRemoteCreate no está dentro del alcance de este cambio.
Si la aplicación solo importa referencias de métodos de pago existentes desde una pasarela de pago externa, como Stripe, Braintree, Authorize.Net, Adyen o PayPal, y solo llama a customerPaymentMethodRemoteCreate, entonces no es necesario tomar medidas en relación con el requisito de mTLS para el endpoint de depósito de tarjetas.
La razón es que este tipo de llamadas importan referencias de métodos de pago existentes de la pasarela externa y no envían datos originales de titulares de tarjetas al endpoint de depósito de tarjetas de Shopify.
¿Qué es mTLS?
mTLS significa TLS mutuo, es decir, autenticación TLS bidireccional.
En HTTPS/TLS normal, generalmente el cliente verifica la identidad del servidor. Por ejemplo, cuando un navegador accede a un sitio web, verifica si el certificado del sitio es confiable. mTLS, por otro lado, requiere que ambas partes verifiquen la otra: el cliente verifica que el servidor sea confiable y el servidor también verifica que el cliente sea confiable.
En el contexto de pagos de Shopify, el significado de mTLS es que la solicitud no solo debe transmitirse a través de un canal cifrado, sino que también debe poder demostrar quién está iniciando la solicitud.
Shopify también menciona en los requisitos técnicos de la extensión de pagos que las extensiones de pago deben usar mTLS para garantizar la seguridad y confiabilidad de la comunicación bidireccional entre Shopify y la extensión de pago. Para las solicitudes de pago, reembolso, captura, anulación, etc., que Shopify inicia hacia el servidor de la aplicación de pago, la aplicación de pago debe verificar que la solicitud provenga efectivamente de Shopify.
El enfoque de este changelog es ligeramente diferente: se centra en que las aplicaciones que envían datos de tarjetas al endpoint de depósito de tarjetas de Shopify deben proporcionar un certificado de cliente emitido por Shopify para que Shopify pueda verificar la identidad del remitente.
¿Por qué Shopify está realizando esta migración?
La razón que Shopify proporciona es muy directa: todo el tráfico de datos de titulares de tarjetas que llega al endpoint de depósito de tarjetas debe poder atribuirse a un llamador autenticado.
Es decir, Shopify quiere asegurarse de que cada solicitud de datos de tarjetas enviada a ese endpoint pueda confirmar su origen.
Este cambio también ha sido descrito por Shopify como una preparación de seguridad importante antes del Black Friday y Cyber Monday de 2026. El certificado de cliente mTLS es un requisito previo para que Shopify rechace el tráfico de depósitos no autenticados en el futuro.
Para las aplicaciones que manejan datos de pago, esta también es una dirección razonable de mejora de seguridad: aumentar la identificabilidad del tráfico de envío de datos de titulares de tarjetas, reducir el riesgo de tráfico no autenticado que ingresa a endpoints sensibles, fortalecer la confianza bidireccional en la cadena de pagos y establecer requisitos operativos más claros para la rotación y monitoreo de certificados.
Impacto real en desarrolladores y proveedores de servicios
Si la aplicación se ve afectada, el impacto principal se concentra en tres puntos.
1. Las solicitudes de depósito necesitan ser modificadas
Al llamar al endpoint de depósito de tarjetas /sessions, se debe incluir el certificado de cliente mTLS emitido por Shopify.
Las mutaciones de la API de administración de GraphQL existentes no cambian. La forma de llamar a customerPaymentMethodCreditCardCreate y customerPaymentMethodCreditCardUpdate no ha cambiado debido a este cambio, aún se pasa el identificador de sesión devuelto por la llamada de depósito.
2. El proceso de OAuth no se ve afectado
La documentación oficial de Shopify indica que mTLS no se utiliza para obtener un token de acceso de OAuth. Las solicitudes que utilizan mutaciones de GraphQL de Shopify aún se autentican mediante un token de acceso de OAuth. No interpretes este cambio como un ajuste en el método de autenticación de OAuth.
3. Los certificados se convertirán en nuevos objetos de operación
Shopify menciona que el primer certificado será emitido manualmente por Shopify y generalmente tomará unos días. Una vez completado el primer certificado, se puede rotar de forma autónoma a través del Servicio de Firma de Certificados de Shopify.
La validez del certificado es de 1 año. Perder la rotación puede llevar a que los depósitos se detengan, por lo que la fecha de caducidad del certificado debe incluirse en el monitoreo, alertas y procesos de verificación de lanzamiento.
Lista de acciones recomendadas
Si mantienes aplicaciones relacionadas con pagos de Shopify, puedes revisar en el siguiente orden.
Primer paso: confirmar si se llaman mutaciones afectadas
Revisa el código, scripts de tareas, herramientas de migración y servicios en segundo plano para ver si se llaman a customerPaymentMethodCreditCardCreate o customerPaymentMethodCreditCardUpdate.
Si es así, continúa confirmando si se enviarán datos originales de la tarjeta al endpoint de depósito de tarjetas /sessions de Shopify.
Segundo paso: distinguir entre importación remota y depósito de tarjetas
Si solo se llama a customerPaymentMethodRemoteCreate y solo se importan referencias de métodos de pago existentes de una pasarela externa, según la explicación actual de Shopify, no está dentro del alcance de esta migración a mTLS.
Si existen lógicas de importación remota y depósito de tarjetas al mismo tiempo, deben manejarse por separado, no se puede concluir solo observando el nombre de la aplicación o el nombre del módulo de negocio.
Tercer paso: solicitar el certificado de cliente emitido por Shopify
Shopify requiere que las aplicaciones afectadas soliciten un certificado a shopify-mtls-partnerships@shopify.com. Al solicitar, se debe proporcionar el ID del cliente de la API y el contacto técnico.
Dado que el primer certificado será emitido manualmente por Shopify y tomará unos días, no se recomienda esperar hasta octubre para manejarlo.
Cuarto paso: modificar la llamada de depósito /sessions
Al realizar una solicitud a https://checkout-mtls.pci.shopifyinc.com/sessions, incluye el certificado. Una vez completado, continúa pasando el identificador de sesión devuelto a la mutación correspondiente de la API de administración de GraphQL. La mutación de GraphQL en sí no necesita ajustarse para la autenticación mTLS debido a esta migración.
Quinto paso: verificar y monitorear
Una vez completada la migración, es necesario confirmar que el tráfico de depósitos ya incluye un certificado válido. Shopify verificará el corte en su lado.
También se recomienda aumentar el monitoreo del tiempo de caducidad del certificado, la tasa de fallos de solicitudes de depósito, alertas de fallos de apretón de manos mTLS, ensayos del proceso de rotación de certificados y evaluaciones de riesgo de congelación de lanzamientos antes del 15 de octubre.
Recordatorio para marcas y proveedores de servicios
Si eres un comerciante de Shopify, una marca DTC o un equipo de comercio electrónico transfronterizo, generalmente no necesitas manejar la migración del código mTLS tú mismo. Pero si utilizas servicios de pago personalizados, migración de suscripciones, almacenamiento de tarjetas, migración de métodos de pago de clientes, se recomienda confirmar con el proveedor de servicios:
- Si se involucra customerPaymentMethodCreditCardCreate o customerPaymentMethodCreditCardUpdate;
- Si se envían datos de titulares de tarjetas al endpoint de depósito de tarjetas de Shopify;
- Si ya se ha solicitado el certificado de cliente mTLS emitido por Shopify;
- Si se puede completar el lanzamiento y la verificación antes del 15 de octubre de 2026;
- Si se ha establecido el monitoreo de rotación y caducidad de certificados.
Este tipo de cambio puede parecer de bajo nivel, pero una vez que se pierde la fecha límite, el impacto puede reflejarse directamente en el nivel de negocio: nuevos datos de tarjetas no se pueden almacenar, los procesos de migración de suscripciones o métodos de pago de clientes se interrumpen.
Resumen
La migración a mTLS de Shopify se centra en establecer requisitos de autenticación más estrictos para las aplicaciones que envían datos de titulares de tarjetas al endpoint de depósito de tarjetas de Shopify.
Los objetos a los que se debe prestar especial atención son aquellos que llaman a customerPaymentMethodCreditCardCreate, customerPaymentMethodCreditCardUpdate y dependen del proceso de depósito /sessions para obtener el identificador de sesión.
Si la aplicación solo utiliza customerPaymentMethodRemoteCreate para importar referencias de métodos de pago de pasarelas externas, según la explicación actual de Shopify, no es necesario tomar medidas en relación con este cambio.
La fecha límite es el 15 de octubre de 2026. Dado que el primer certificado necesita ser emitido manualmente por Shopify y después del lanzamiento también debe ser verificado y monitoreado, se recomienda que los equipos relevantes revisen, soliciten certificados y completen la verificación gradual lo antes posible.
Fuentes de referencia
- Changelog de desarrolladores de Shopify: El endpoint de depósito de tarjetas ahora requiere un certificado mTLS (2026-07-16)
- Changelog de desarrolladores de Shopify: renovación del certificado de cliente mTLS para aplicaciones de pagos (2026-04-16)
- API de administración de GraphQL de Shopify: customerPaymentMethodCreditCardCreate / customerPaymentMethodCreditCardUpdate / customerPaymentMethodRemoteCreate
- Consideraciones de implementación de aplicaciones de pagos de Shopify