Logo

Shopify Zahlungsanwendungen Hinweis: mTLS-Migration muss bis zum 15. Oktober abgeschlossen sein

avatar jayce 18 Jul 2026

Am 16. Juli veröffentlichte Shopify in den Entwickler-Update-Logs eine Änderung, die die Sicherheit von Zahlungsdaten betrifft: Anwendungen, die auf spezifische Weise Kartendaten an Shopify übermitteln, müssen bis zum 15. Oktober 2026 die mTLS-Migration abgeschlossen haben.

Diese Änderung betrifft nicht alle Shopify-Anwendungen, und nicht alle Zahlungsanwendungen sind betroffen. Genauer gesagt betrifft sie Anwendungen, die die ursprünglichen Kreditkarteninhaberdaten an den Shopify card-deposit Endpoint übermitteln.

Wenn Ihr Team Shopify-Zahlungsanwendungen, Migrationswerkzeuge für Abonnements, Importwerkzeuge für Zahlungsmethoden verwaltet oder maßgeschneiderte Entwicklungen für DTC-Marken anbietet, sollten Sie diese Änderung so schnell wie möglich überprüfen.

Was sind die spezifischen Anforderungen von Shopify?

Laut dem offiziellen Changelog von Shopify verlangt der card-deposit Endpoint jetzt, dass die Anfragen ein von Shopify ausgestelltes mTLS-Clientzertifikat mitführen.

Der betroffene Endpoint ist: https://checkout-mtls.pci.shopifyinc.com/sessions

Dieser Endpoint selbst bleibt unverändert, die Änderung besteht darin, dass in Zukunft jede Anfrage, die Kartendaten an ihn übermittelt, ein von Shopify ausgestelltes mTLS-Clientzertifikat mitführen muss.

Shopify gibt den Stichtag für die Migration mit dem 15. Oktober 2026 an. Nach Beginn der Umsetzung werden Anfragen ohne gültiges Zertifikat abgelehnt. Anwendungen, die die Migration nicht abgeschlossen haben, können keine neuen Kartendaten mehr an Shopify übermitteln.

Welche APIs / Anwendungen sind betroffen?

Betroffen sind Anwendungen, die Kartendaten über den Shopify card-deposit Endpoint übermitteln und anschließend die folgenden GraphQL Admin API-Mutationen aufrufen:

  • customerPaymentMethodCreditCardCreate
  • customerPaymentMethodCreditCardUpdate

Diese beiden Mutationen hängen von sessionId ab. Diese sessionId stammt von der Anwendung, die die Kartendaten an den Shopify /sessions card-deposit Endpoint übermittelt.

Der typische Ablauf kann wie folgt verstanden werden: Die Anwendung verarbeitet die ursprünglichen Kartendaten in einer PCI-konformen Umgebung; übermittelt die Kartendaten an den Shopify /sessions Endpoint; Shopify gibt einen Sitzungsbezeichner zurück; die Anwendung ruft dann customerPaymentMethodCreditCardCreate oder customerPaymentMethodCreditCardUpdate auf und übergibt den Sitzungsbezeichner an Shopify.

Solche Szenarien treten typischerweise bei der Speicherung von Karten, der Aktualisierung von Karten, der Migration von Zahlungsmethoden für Abonnements, der Erfassung von Zahlungsmethoden für Kunden usw. auf.

Welche Anwendungen sind nicht betroffen?

Shopify stellt klar, dass customerPaymentMethodRemoteCreate nicht von dieser Änderung betroffen ist.

Wenn die Anwendung lediglich vorhandene Zahlungsmethoden von externen Zahlungsanbietern importiert, wie z.B. Stripe, Braintree, Authorize.Net, Adyen oder PayPal, und nur customerPaymentMethodRemoteCreate aufruft, sind keine Maßnahmen bezüglich der mTLS-Anforderungen für den card-deposit Endpoint erforderlich.

Der Grund dafür ist, dass solche Aufrufe lediglich Verweise auf vorhandene Zahlungsmethoden von externen Anbietern importieren und keine ursprünglichen Kartendaten an den card-deposit Endpoint von Shopify übermitteln.

Was ist mTLS?

mTLS steht für mutual TLS, also bidirektionale TLS-Authentifizierung.

Bei normalem HTTPS/TLS überprüft in der Regel der Client die Identität des Servers. Wenn beispielsweise ein Browser eine Website besucht, wird überprüft, ob das Zertifikat der Website vertrauenswürdig ist. mTLS verlangt jedoch zusätzlich, dass beide Seiten sich gegenseitig überprüfen: Der Client überprüft die Vertrauenswürdigkeit des Servers, und der Server überprüft die Vertrauenswürdigkeit des Clients.

Im Kontext von Shopify-Zahlungen bedeutet mTLS, dass Anfragen nicht nur über einen verschlüsselten Kanal übertragen werden müssen, sondern auch nachweisen müssen, wer die Anfrage initiiert hat.

Shopify erwähnt in den technischen Anforderungen für Zahlungsanwendungen, dass Zahlungsanwendungen mTLS verwenden müssen, um die Sicherheit und Vertrauenswürdigkeit der bidirektionalen Kommunikation zwischen Shopify und den Zahlungsanwendungen zu gewährleisten. Bei Anfragen von Shopify an die Zahlungsanwendungsserver, wie z.B. Zahlung, Rückerstattung, Erfassung, Stornierung usw., muss die Zahlungsanwendung überprüfen, dass die Anfrage tatsächlich von Shopify stammt.

Der Schwerpunkt dieses Changelogs ist etwas anders: Es geht darum, dass Anwendungen, die Kartendaten an den Shopify card-deposit Endpoint übermitteln, ein von Shopify ausgestelltes Clientzertifikat bereitstellen müssen, damit Shopify die Identität des Einreichenden überprüfen kann.

Warum führt Shopify diese Migration durch?

Der Grund, den Shopify offiziell angibt, ist sehr direkt: Alle Kartendaten, die den card-deposit Endpoint erreichen, müssen einem authentifizierten Aufrufer zugeordnet werden können.

Das bedeutet, dass Shopify sicherstellen möchte, dass jede Anfrage zur Übermittlung von Kartendaten an diesen Endpoint die Quelle bestätigen kann.

Diese Änderung wird von Shopify auch als wichtige Sicherheitsvorbereitung vor dem Black Friday und Cyber Monday 2026 beschrieben. Das mTLS-Clientzertifikat ist die Voraussetzung dafür, dass Shopify nicht authentifizierte Deposit-Anfragen ablehnen kann.

Für Anwendungen, die Zahlungsdaten verarbeiten, ist dies auch ein sinnvoller Schritt in Richtung Sicherheitsupgrade: die Erhöhung der Identifizierbarkeit des Datenverkehrs zur Übermittlung von Kartendaten, die Verringerung des Risikos, dass nicht authentifizierter Datenverkehr in sensible Endpoints gelangt, die Stärkung des gegenseitigen Vertrauens in der Zahlungsabwicklung und die Schaffung klarerer Betriebsanforderungen für die Zertifikatsrotation und -überwachung.

Praktische Auswirkungen auf Entwickler und Dienstleister

Wenn die Anwendung betroffen ist, konzentrieren sich die Hauptauswirkungen auf drei Punkte.

1. Deposit-Anfragen müssen umgestaltet werden

Bei der Aufruf des /sessions card-deposit Endpoints muss das von Shopify ausgestellte mTLS-Clientzertifikat mitgeführt werden.

Die bestehenden GraphQL Admin API Vault-Mutationen bleiben unverändert. Die Aufrufweise von customerPaymentMethodCreditCardCreate und customerPaymentMethodCreditCardUpdate hat sich durch diese Änderung nicht verändert und übergibt weiterhin den von der Deposit-Anfrage zurückgegebenen Sitzungsbezeichner.

2. OAuth-Prozess bleibt unberührt

Die offiziellen Dokumente von Shopify erklären, dass mTLS nicht zur Erlangung eines OAuth-Zugriffstokens verwendet wird. Anfragen, die die Shopify GraphQL-Mutationen verwenden, werden weiterhin über OAuth-Zugriffstoken authentifiziert. Verstehen Sie diese Änderung nicht als Anpassung der OAuth-Authentifizierungsmethode.

3. Zertifikate werden zu neuen Betriebsobjekten

Shopify erwähnt, dass das erste Zertifikat manuell von Shopify ausgestellt wird und in der Regel einige Tage benötigt. Nach dem ersten Zertifikat kann die Rotation über den Certificate Signing Service von Shopify selbstständig erfolgen.

Die Gültigkeitsdauer des Zertifikats beträgt 1 Jahr. Das Versäumen der Rotation kann dazu führen, dass die Einzahlungen gestoppt werden, daher muss das Ablaufdatum des Zertifikats in die Überwachungs-, Alarm- und Veröffentlichungsprüfprozesse einbezogen werden.

Handlungsempfehlungen

Wenn Sie Shopify-Zahlungsanwendungen verwalten, können Sie die folgenden Schritte zur Überprüfung durchführen.

Schritt 1: Bestätigen Sie, ob betroffene Mutationen aufgerufen werden

Überprüfen Sie den Code, die Skripte, die Migrationswerkzeuge und die Backend-Dienste, um festzustellen, ob customerPaymentMethodCreditCardCreate oder customerPaymentMethodCreditCardUpdate aufgerufen wird.

Wenn ja, bestätigen Sie, ob Kartendaten an den Shopify /sessions card-deposit Endpoint übermittelt werden.

Schritt 2: Unterscheidung zwischen Remote-Import und Card Deposit

Wenn nur customerPaymentMethodRemoteCreate aufgerufen wird und lediglich Verweise auf vorhandene Zahlungsmethoden von externen Anbietern importiert werden, fällt dies laut den aktuellen Shopify-Anweisungen nicht in den Geltungsbereich der mTLS-Migration.

Wenn sowohl Remote-Import- als auch Kreditkarten-Deposit-Logik vorhanden sind, müssen diese separat behandelt werden; es reicht nicht aus, nur den Anwendungsnamen oder den Namen des Geschäftsmoduls zu betrachten, um eine Schlussfolgerung zu ziehen.

Schritt 3: Beantragen Sie das von Shopify ausgestellte Client-Zertifikat

Shopify verlangt von betroffenen Anwendungen, dass sie das Zertifikat bei shopify-mtls-partnerships@shopify.com beantragen. Bei der Beantragung müssen die API-Client-ID und der technische Kontakt angegeben werden.

Da das erste Zertifikat manuell von Shopify ausgestellt wird und einige Tage benötigt, wird empfohlen, nicht bis Oktober zu warten, um dies zu erledigen.

Schritt 4: Umgestaltung des /sessions Deposit-Aufrufs

Fügen Sie bei der Anfrage an https://checkout-mtls.pci.shopifyinc.com/sessions das Zertifikat hinzu. Nachdem dies abgeschlossen ist, übergeben Sie den zurückgegebenen Sitzungsbezeichner an die entsprechenden GraphQL Admin API-Mutationen. Die GraphQL-Mutationen selbst müssen aufgrund dieser Migration nicht auf mTLS-Authentifizierung umgestellt werden.

Schritt 5: Überprüfung und Überwachung

Nach Abschluss der Migration muss sichergestellt werden, dass der Deposit-Verkehr ein gültiges Zertifikat mitführt. Shopify wird auf seiner Seite die Umstellung überprüfen.

Es wird auch empfohlen, die Überwachung des Ablaufdatums des Zertifikats, die Überwachungsrate von fehlgeschlagenen Deposit-Anfragen, Alarme bei mTLS-Handshake-Fehlern, Übungen zur Zertifikatsrotation sowie eine Risikobewertung für die Bereitstellung vor dem 15. Oktober zu erhöhen.

Hinweise für Marken und Dienstleister

Wenn Sie Shopify-Händler, DTC-Marke oder grenzüberschreitendes E-Commerce-Team sind, müssen Sie in der Regel den mTLS-Code-Migrationsprozess nicht selbst durchführen. Wenn Sie jedoch maßgeschneiderte Zahlungen, Abonnementmigrationen, Kartenspeicherung, Migration von Zahlungsmethoden für Kunden usw. verwenden, wird empfohlen, bei Ihrem Dienstleister zu bestätigen:

  • Ob customerPaymentMethodCreditCardCreate oder customerPaymentMethodCreditCardUpdate betroffen ist;
  • Ob Kartendaten an den Shopify card-deposit Endpoint übermittelt werden;
  • Ob bereits ein von Shopify ausgestelltes mTLS-Clientzertifikat beantragt wurde;
  • Ob die Implementierung und Validierung bis zum 15. Oktober 2026 abgeschlossen werden kann;
  • Ob eine Überwachung der Zertifikatsrotation und -ablauf eingerichtet wurde.

Diese Art von Änderungen mag auf den ersten Blick grundlegend erscheinen, aber wenn der Stichtag verpasst wird, kann sich dies direkt auf die Geschäftsebene auswirken: Neue Kartendaten können nicht gespeichert werden, und die Prozesse zur Migration von Abonnements oder Zahlungsmethoden für Kunden werden unterbrochen.

Fazit

Die mTLS-Migration von Shopify zielt darauf ab, strengere Identitätsanforderungen für Anwendungen einzuführen, die Kartendaten an den Shopify card-deposit Endpoint übermitteln.

Besondere Aufmerksamkeit sollte den Anwendungen gewidmet werden, die customerPaymentMethodCreditCardCreate, customerPaymentMethodCreditCardUpdate aufrufen und auf den /sessions Deposit-Prozess angewiesen sind, um den Sitzungsbezeichner zu erhalten.

Wenn die Anwendung nur customerPaymentMethodRemoteCreate verwendet, um Verweise auf Zahlungsmethoden von externen Anbietern zu importieren, sind laut den aktuellen Shopify-Anweisungen keine Maßnahmen bezüglich dieser Änderung erforderlich.

Der Stichtag ist der 15. Oktober 2026. Angesichts der Tatsache, dass das erste Zertifikat manuell von Shopify ausgestellt werden muss und nach der Implementierung auch validiert und überwacht werden muss, wird empfohlen, dass die betroffenen Teams so früh wie möglich die Überprüfung, Beantragung des Zertifikats und die Durchführung von Tests abschließen.

Kontaktieren Sie uns