Attenzione alle applicazioni relative ai pagamenti Shopify: la migrazione mTLS deve essere completata entro il 15 ottobre
Il 16 luglio, Shopify ha pubblicato un cambiamento relativo alla sicurezza dei dati di pagamento nel registro degli aggiornamenti per gli sviluppatori: le applicazioni che depositano i dati del titolare della carta presso Shopify in un modo specifico devono completare la migrazione mTLS entro il 15 ottobre 2026.
Questo cambiamento non riguarda tutte le applicazioni Shopify e non tutte le applicazioni di pagamento saranno influenzate. Più precisamente, colpisce le applicazioni che inviano i dati originali del titolare della carta al punto finale card-deposit di Shopify.
Se il tuo team gestisce applicazioni di pagamento Shopify, strumenti di migrazione degli abbonamenti, strumenti di importazione dei metodi di pagamento, o fornisce sviluppi personalizzati per marchi DTC, vale la pena controllare questa modifica il prima possibile.
Quali sono i requisiti specifici di Shopify?
Secondo il changelog ufficiale di Shopify, il punto finale card-deposit di Shopify ora richiede che le richieste siano accompagnate da un certificato client mTLS emesso da Shopify.
Il punto finale coinvolto è: https://checkout-mtls.pci.shopifyinc.com/sessions
Questo punto finale in sé non è cambiato, la modifica riguarda il fatto che, in futuro, ogni richiesta che invia i dati del titolare della carta a questo punto finale deve includere un certificato client mTLS emesso da Shopify.
La scadenza per la migrazione fornita da Shopify è il 15 ottobre 2026. Una volta avviata l’esecuzione, se la richiesta non ha un certificato valido, le richieste di deposito correlate verranno rifiutate. Le applicazioni che non completano la migrazione non potranno continuare a depositare nuovi dati del titolare della carta presso Shopify.
Quali API / applicazioni saranno influenzate?
Saranno influenzate le applicazioni che inviano i dati del titolare della carta tramite il punto finale card-deposit di Shopify e successivamente chiamano le seguenti mutazioni dell’API GraphQL Admin:
- customerPaymentMethodCreditCardCreate
- customerPaymentMethodCreditCardUpdate
Queste due mutazioni dipendono da sessionId. Questo sessionId proviene dall’app che prima invia i dati della carta al punto finale card-deposit /sessions di Shopify.
Il flusso tipico può essere compreso come segue: l’app gestisce i dati della carta in un ambiente conforme PCI; invia i dati della carta al punto finale /sessions di Shopify; Shopify restituisce un identificatore di sessione; l’app chiama quindi customerPaymentMethodCreditCardCreate o customerPaymentMethodCreditCardUpdate, passando l’identificatore di sessione a Shopify.
Questi scenari si presentano comunemente in attività come il salvataggio della carta, l’aggiornamento della carta, la migrazione dei metodi di pagamento per abbonamenti, l’importazione dei metodi di pagamento dei clienti, ecc.
Quali applicazioni non saranno influenzate?
Shopify ha chiarito che customerPaymentMethodRemoteCreate non rientra nell’ambito di questo cambiamento.
Se l’app importa semplicemente riferimenti a metodi di pagamento esistenti da gateway di pagamento esterni, come Stripe, Braintree, Authorize.Net, Adyen o PayPal, e chiama solo customerPaymentMethodRemoteCreate, non è necessario intraprendere azioni riguardo ai requisiti mTLS per il punto finale card-deposit.
Il motivo è che tali chiamate importano solo riferimenti a metodi di pagamento già esistenti nel gateway esterno e non inviano i dati originali del titolare della carta al punto finale card-deposit di Shopify.
Cos’è mTLS?
mTLS sta per mutual TLS, ovvero autenticazione TLS bidirezionale.
Nella normale HTTPS/TLS, di solito il client verifica l’identità del server. Ad esempio, quando un browser accede a un sito web, controlla se il certificato del sito è attendibile. mTLS richiede ulteriormente che entrambe le parti verifichino l’altra: il client verifica che il server sia attendibile e il server verifica che il client sia attendibile.
Nel contesto dei pagamenti Shopify, il significato di mTLS è che la richiesta deve non solo essere trasmessa tramite un canale crittografato, ma deve anche dimostrare chi sta effettuando la richiesta.
Shopify ha anche menzionato nei requisiti tecnici per le estensioni di pagamento che le estensioni di pagamento devono utilizzare mTLS per garantire la sicurezza e l’affidabilità della comunicazione bidirezionale tra Shopify e l’estensione di pagamento. Per le richieste di pagamento, rimborso, cattura, annullamento, ecc. da Shopify al server dell’app di pagamento, l’app di pagamento deve verificare che la richiesta provenga effettivamente da Shopify.
Il punto focale di questo changelog è leggermente diverso: riguarda il fatto che quando l’app invia i dati della carta al punto finale card-deposit di Shopify, l’app deve fornire un certificato client emesso da Shopify, in modo che Shopify possa verificare l’identità del mittente.
Perché Shopify sta effettuando questa migrazione?
La ragione fornita ufficialmente da Shopify è molto diretta: tutto il traffico di dati del titolare della carta che raggiunge il punto finale card-deposit deve poter essere attribuito a un chiamante autenticato.
In altre parole, Shopify desidera garantire che ogni richiesta di dati della carta inviata a questo punto finale possa confermare la provenienza.
Questo cambiamento è stato anche descritto da Shopify come una preparazione di sicurezza importante prima del Black Friday e del Cyber Monday del 2026. Il certificato client mTLS è il presupposto per Shopify per rifiutare il traffico di deposito non autenticato in seguito.
Per le applicazioni che gestiscono i dati di pagamento, questo rappresenta anche una direzione ragionevole per un aggiornamento della sicurezza: aumentare l’identificabilità del traffico di invio dei dati del titolare della carta, ridurre il rischio di traffico non autenticato che entra in punti finali sensibili, rafforzare la fiducia bidirezionale nella catena di pagamento e stabilire requisiti operativi più chiari per il monitoraggio della rotazione e della scadenza dei certificati.
Impatti pratici per sviluppatori e fornitori di servizi
Se l’app è influenzata, gli impatti principali si concentrano su tre punti.
1. Le richieste di deposito devono essere modificate
Quando si chiama il punto finale /sessions card-deposit, è necessario includere il certificato client mTLS emesso da Shopify.
Le mutazioni dell’API GraphQL Admin esistenti rimangono invariate. Le modalità di chiamata di customerPaymentMethodCreditCardCreate e customerPaymentMethodCreditCardUpdate non sono cambiate a causa di questo cambiamento e continuano a ricevere l’identificatore di sessione restituito dalla chiamata di deposito.
2. Il processo OAuth non è influenzato
La documentazione ufficiale di Shopify chiarisce che mTLS non è utilizzato per ottenere il token di accesso OAuth. Le richieste che utilizzano le mutazioni GraphQL di Shopify continuano a essere autenticate tramite il token di accesso OAuth. Non interpretare questo cambiamento come un aggiustamento del metodo di autenticazione OAuth.
3. I certificati diventeranno nuovi oggetti di gestione operativa
Shopify ha menzionato che il primo certificato sarà emesso manualmente da Shopify e di solito richiede alcuni giorni. Una volta completato il primo certificato, le rotazioni successive possono essere effettuate autonomamente tramite il servizio di firma dei certificati di Shopify.
La validità del certificato è di 1 anno. Perdere la scadenza della rotazione potrebbe portare a un’interruzione del deposito, quindi la data di scadenza del certificato deve essere inclusa nei processi di monitoraggio, allerta e verifica.
Elenco di azioni consigliate
Se gestisci applicazioni relative ai pagamenti Shopify, puoi controllare nell’ordine seguente.
Primo passo: confermare se si chiamano mutazioni influenzate
Controlla nel codice, negli script di lavoro, negli strumenti di migrazione e nei servizi di backend se si chiamano customerPaymentMethodCreditCardCreate o customerPaymentMethodCreditCardUpdate.
Se sì, continua a confermare se verranno inviati dati originali della carta al punto finale card-deposit /sessions di Shopify.
Secondo passo: distinguere tra importazione remota e deposito della carta
Se chiami solo customerPaymentMethodRemoteCreate e stai solo importando riferimenti a metodi di pagamento esistenti da gateway esterni, secondo le attuali indicazioni di Shopify, non rientri nell’ambito di questa migrazione mTLS.
Se esistono logiche sia di importazione remota che di deposito della carta, è necessario gestirle separatamente, non basta guardare il nome dell’app o il nome del modulo aziendale per trarre conclusioni.
Terzo passo: richiedere il certificato client emesso da Shopify
Shopify richiede che le applicazioni influenzate richiedano un certificato a shopify-mtls-partnerships@shopify.com. Durante la richiesta è necessario fornire l’ID client API e il contatto tecnico.
Poiché il primo certificato è emesso manualmente da Shopify e richiede alcuni giorni, non è consigliabile aspettare fino a ottobre per gestirlo.
Quarto passo: modificare la chiamata di deposito /sessions
Quando si effettua una richiesta a https://checkout-mtls.pci.shopifyinc.com/sessions, includere il certificato. Dopo aver completato, continua a passare l’identificatore di sessione restituito alle corrispondenti mutazioni dell’API GraphQL Admin. La mutazione GraphQL stessa non deve essere adattata per l’autenticazione mTLS a causa di questa migrazione.
Quinto passo: verifica e monitoraggio
Dopo aver completato la migrazione, è necessario confermare che il traffico di deposito sia già accompagnato da un certificato valido. Shopify verificherà il cutover dal proprio lato.
Si consiglia inoltre di aumentare il monitoraggio della scadenza del certificato, il monitoraggio del tasso di fallimento delle richieste di deposito, gli avvisi di fallimento della stretta di mano mTLS, le esercitazioni sul processo di rotazione dei certificati e la valutazione del rischio di congelamento del rilascio prima del 15 ottobre.
Promemoria per marchi e fornitori di servizi
Se sei un commerciante Shopify, un marchio DTC o un team di e-commerce transfrontaliero, di solito non è necessario gestire autonomamente la migrazione del codice mTLS. Ma se utilizzi servizi di pagamento personalizzati, migrazione degli abbonamenti, salvataggio della carta, migrazione dei metodi di pagamento dei clienti, è consigliabile confermare con il fornitore di servizi:
- Se coinvolge customerPaymentMethodCreditCardCreate o customerPaymentMethodCreditCardUpdate;
- Se invia dati del titolare della carta al punto finale card-deposit di Shopify;
- Se hai già richiesto un certificato client mTLS emesso da Shopify;
- Se puoi completare il rilascio e la verifica entro il 15 ottobre 2026;
- Se hai già stabilito il monitoraggio della rotazione e della scadenza dei certificati.
Questi cambiamenti possono sembrare di basso livello, ma una volta superata la scadenza, l’impatto potrebbe riflettersi direttamente a livello aziendale: i nuovi dati della carta non possono essere registrati, i processi di migrazione dei metodi di pagamento per abbonamenti o clienti si interrompono.
Riepilogo
La migrazione mTLS di Shopify si concentra sull’imporre requisiti di autenticazione più rigorosi per le applicazioni che inviano i dati del titolare della carta al punto finale card-deposit di Shopify.
Le applicazioni che devono prestare particolare attenzione sono quelle che chiamano customerPaymentMethodCreditCardCreate, customerPaymentMethodCreditCardUpdate e dipendono dal processo di deposito /sessions per ottenere l’identificatore di sessione.
Se l’app utilizza solo customerPaymentMethodRemoteCreate per importare riferimenti a metodi di pagamento da gateway esterni, secondo le attuali indicazioni di Shopify, non è necessario intraprendere azioni riguardo a questo cambiamento.
La scadenza è il 15 ottobre 2026. Considerando che il primo certificato deve essere emesso manualmente da Shopify e che dopo il rilascio deve essere verificato e monitorato, si consiglia ai team interessati di controllare, richiedere il certificato e completare la verifica graduale il prima possibile.
Fonti di riferimento
- Changelog per sviluppatori Shopify: Il punto finale del deposito della carta ora richiede un certificato mTLS (2026-07-16)
- Changelog per sviluppatori Shopify: rinnovo del certificato client mTLS per le app di pagamento (2026-04-16)
- API GraphQL Admin di Shopify: customerPaymentMethodCreditCardCreate / customerPaymentMethodCreditCardUpdate / customerPaymentMethodRemoteCreate
- Considerazioni per l’implementazione delle app di pagamento Shopify