Blog-Inhalte
September 11, 2026

Shopify Craftgate Integration: Schritt für Schritt Einrichtungsanleitung

Die Shopify-Craftgate-Integration ist eine Einrichtung, mit der Sie virtuelle POS-Systeme von Banken und alternative Zahlungsmethoden über ein einziges Dashboard verwalten können. Schritt-für-Schritt-Anleitung.

Bei den von uns betreuten Shopify-Projekten sind wir bei Shops mit mehreren Bankverträgen immer wieder auf ein Problem gestoßen: Ein an eine einzige Bank angebundenes virtuelles POS legt den Verkauf komplett lahm, sobald diese Bank die Zahlung vorübergehend ablehnt. Craftgate ist eine Shopify-Zahlungsintegration, die genau dieses Risiko streut. Als Zahlungsdienstleister bündelt das System virtuelle POS-Terminals verschiedener Banken sowie alternative Zahlungsmethoden in einem einzigen Dashboard. Anstatt sich auf einen einzigen Zahlungsanbieter wie iyzico oder PayTR verlassen zu müssen, ermöglicht es Ihnen, mehrere Bankverträge Ihres Shops über eine einzige Integration zu verwalten.

Was ist die Shopify Craftgate Integration?

Die Craftgate-Integration ist eine Payment-Routing-Ebene, die Ihren Shopify-Shop über eine einzige API-Verbindung mit mehreren virtuellen POS-Terminals und alternativen Zahlungsmethoden verknüpft. Laut der eigenen Definition von Craftgate bietet die Plattform ein Multi-Provider-Management über eine einzige Infrastruktur, anstatt separate Integrationen mit jedem Zahlungsdienstleister oder jeder Bank einzeln vornehmen zu müssen.

Laut einer Ankündigung von Fintechistanbul.org aus dem Jahr 2022 wurde die Zusammenarbeit zwischen Craftgate und Shopify in jenem Jahr offiziell und die Craftgate Payment Gateway-App wurde in den Shopify App Store aufgenommen. Wie in der Entwicklerdokumentation von Craftgate beschrieben, bietet die App zwei verschiedene Zahlungserlebnisse: die Common Payment Page (CPP), bei der der Kunde auf eine von Craftgate gehostete Seite weitergeleitet wird, und die On-Site-Zahlung, bei der der Kunde seine Kartendaten eingibt, ohne den Checkout-Prozess von Shopify zu verlassen.

Es gibt drei technische Merkmale, die die Shopify-Integration von Craftgate von anderen Anbietern mit nur einem Zahlungsdienstleister unterscheiden:

  • Echtzeit-Synchronisierung: Das Zahlungsergebnis wird sofort nach Abschluss des Vorgangs im Shopify-Bestellbildschirm angezeigt; eine separate Webhook-Konfiguration oder manuelle Synchronisierungsschritte sind nicht erforderlich.
  • Zahlungswiederholung und Autopilot (Payment Retry & Autopilot): Wenn eine Transaktion abgelehnt wird, leitet das System den Vorgang gemäß vordefinierter Regeln automatisch an eine andere Bank weiter und versucht es erneut.
  • Intelligentes und dynamisches Payment-Routing (Smart/Dynamic Payment Routing): Craftgate bestimmt automatisch, welches virtuelle POS welcher Bank für die jeweilige Transaktion genutzt wird, basierend auf Kriterien wie Transaktionsbetrag, Kartentyp oder Erfolgsquote.
Wichtiger Hinweis: Der Eintrag der Craftgate Payment Gateway-App im Shopify App Store weist seit der Veröffentlichung im Jahr 2022 keine Bewertungen auf. Das bedeutet nicht, dass die App nicht funktioniert; es zeigt lediglich, dass Craftgate die Shopify-Integration direkt über die eigene Entwicklerdokumentation unterstützt und die App-Store-Bewertungen nicht priorisiert. Bestätigen Sie vor Beginn der Einrichtung die aktuellen Integrationsschritte über den Support-Kanal von Craftgate.

Für kleine Shops, die nur mit einem virtuellen POS arbeiten und kein Multi-Bank-Management benötigen, könnte diese Ebene unnötig komplex sein; der wahre Mehrwert von Craftgate zeigt sich erst bei Shops mit mehreren Bankverträgen.

Eröffnung eines Craftgate-Kontos: Antrag und Sandbox-Test

Um ein Craftgate-Konto zu eröffnen, müssen Sie das Antragsformular auf craftgate.io ausfüllen und Ihre Unternehmensdaten sowie Details zu Ihren Bankverträgen übermitteln. Nach der Genehmigung erhalten Sie Ihre API-Schlüssel über das Live-Dashboard.

Antrag für die Live-Umgebung

Der Antrag über die offizielle Website von Craftgate unterscheidet sich von einem klassischen Antrag für ein virtuelles POS dadurch, dass nicht nur Informationen zu einer Bank, sondern zu allen Banken gesammelt werden, mit denen Ihr Shop zusammenarbeitet. Nach Genehmigung des Antrags erhalten Sie im Craftgate-Dashboard ein Paar aus API Key und Secret Key; diese Schlüssel werden bei der App-Einrichtung auf Shopify verwendet.

Ein Punkt, der während des Antragsprozesses geklärt werden sollte, ist die Reihenfolge, in der die Banken definiert werden sollen. Wenn Sie mehrere Bankverträge haben, sollten Sie vorab mit dem Vertriebsteam von Craftgate besprechen, ob diese auf einmal oder schrittweise hinzugefügt werden sollen, um Verwirrung bei der Einrichtung zu vermeiden.

Sandbox-Umgebung (Testumgebung)

Craftgate bietet eine Testumgebung über sandbox-panel.craftgate.io an, die vollständig vom Live-Panel getrennt ist. Das Sandbox-Konto wird mit einer separaten Registrierung unabhängig vom Live-Konto eröffnet; das bedeutet, Sie können Ihre Live-API-Schlüssel nicht in der Sandbox verwenden, sondern müssen einen eigenen Test-Account erstellen.

In der Sandbox-Umgebung können Sie den vollständigen Zahlungsprozess (Karteneingabe, 3D-Secure-Verifizierung, Zahlungsergebnis) ohne echte Geldbewegungen testen. Laut der Craftgate-Dokumentation simuliert die Sandbox-Umgebung alle Funktionen der Live-Umgebung (einschließlich Zahlungswiederholung und intelligenter Weiterleitung). Daher ist es ratsam, vor dem Livegang nicht nur mit einer Testkarte, sondern mit mindestens zwei verschiedenen Szenarien (erfolgreiche Transaktion, abgelehnte Transaktion) zu testen, um Überraschungen in der Live-Umgebung zu vermeiden.

Shopify Craftgate-Integration: Schritt-für-Schritt-Einrichtung

Die Einrichtung beginnt mit der Eröffnung Ihres Craftgate-Kontos und endet mit dem Testen der über den Shopify App Store installierten Anwendung in der Live-Umgebung; die Schritte dazwischen umfassen die Definition der angebundenen Banken und die Auswahl des Zahlungserlebnisses.

Schritt 1: Craftgate-Konto eröffnen und API-Schlüssel abrufen

Schließen Sie den im vorherigen Abschnitt beschriebenen Bewerbungsprozess ab und rufen Sie Ihre API-Schlüssel über das Craftgate-Panel ab. Ohne diese Schlüssel erfolgt keine Verknüpfung mit Ihrem Anwendungskonto auf Shopify-Seite.

Schritt 2: Craftgate Payment Gateway aus dem Shopify App Store installieren

Gehen Sie in Ihrem Shopify-Admin-Panel zum Bereich „Apps“, suchen Sie nach „Craftgate Payment Gateway“ und installieren Sie es in Ihrem Shop. Die App ist kostenlos; während der Installation wird eine Berechtigung für den Zugriff auf Ihre Shop-Daten angefordert.

Schritt 3: Banken und virtuelle POS-Systeme definieren

Nachdem Sie Ihr Craftgate-Konto innerhalb der App mit den API-Schlüsseln verknüpft haben, legen Sie im Craftgate-Panel fest, welche virtuellen POS-Systeme der Banken und Zahlungsdienstleister aktiv sein sollen. Wenn Sie eine Vereinbarung mit einer Bank haben, die keine direkte Shopify-Integration bietet, können Sie dieses virtuelle POS-System in diesem Schritt ebenfalls in das System einbinden.

Schritt 4: Zahlungserlebnis wählen (Gehostete Zahlungsseite oder On-Site)

Hier entscheiden Sie, ob Ihre Kunden auf eine von Craftgate gehostete Seite weitergeleitet werden oder ob die Zahlung direkt in Ihrem Shopify-Shop erfolgt, ohne diesen zu verlassen. Die On-Site-Option umfasst auch alternative Methoden wie Multinet und Edenred-Geschenkkarten.

Schritt 5: Testtransaktion in der Sandbox durchführen

Führen Sie vor dem Livegang eine Testbestellung mit Ihrem Sandbox-Konto durch, ohne dass echtes Geld fließt. Überprüfen Sie, ob das Zahlungsergebnis korrekt und in Echtzeit im Shopify-Bestellbildschirm angezeigt wird; wird dieser Schritt übersprungen, bemerkt man das Szenario „bezahlt, aber Bestellung nicht sichtbar“ erst in der Live-Umgebung.

Schritt 6: Livegang

Sobald der Testlauf reibungslos abgeschlossen ist, wechseln Sie im Craftgate-Panel in den Live-Modus. Bestätigen Sie in Ihren Shopify-Zahlungseinstellungen, dass Craftgate als aktiver Anbieter angezeigt wird, und überwachen Sie die erste echte Bestellung genau.

Die herausragenden Funktionen von Craftgate

Der wesentliche Unterschied, der Craftgate von einer Einrichtung mit nur einem virtuellen POS einer Bank unterscheidet, ist die Möglichkeit, mehrere Zahlungsquellen über ein einziges Panel zu verwalten und automatische Weiterleitungen zwischen ihnen vorzunehmen.

Merkmal Einzelnes Bank-Virtuelles POS Verwaltung über Craftgate
Anzahl der virtuellen POS Meistens eine einzelne Bank Mehrere Banken und Zahlungsinstitute in einem einzigen Dashboard
Provisionsverhandlung Abhängig von einer einzigen Bank Möglichkeit zum Vergleich von Raten zwischen Anbietern
Bei Zahlungsausfall Erfordert manuellen Eingriff Automatisierte Verwaltung über Smart Retry und Autopilot
Kostenoptimierung Fester Provisionssatz Weiterleitung zum kostengünstigsten POS über Smart and Dynamic Payment Routing
Alternative Zahlungsmethoden Meistens nur Karten Umfangreiche Alternativen einschließlich Multinet, Edenred-Geschenkkarte, GarantiPay

Als Nodus Works beobachten wir bei Shops, die mit mehreren Zahlungsanbietern arbeiten, das häufige Problem, dass der Verkauf komplett zum Erliegen kommt, wenn ein Anbieter ausfällt. Die automatische Weiterleitungslogik von Craftgate verteilt dieses Risiko, anstatt von einem einzigen Anbieter abhängig zu sein. Dies erhöht jedoch auch die Komplexität der Einrichtung, weshalb es für kleine Shops, bei denen eine einzige Bank ausreicht, eine unnötige zusätzliche Ebene darstellen kann.

Vergleich von Craftgate mit iyzico/PayTR

Im Gegensatz zu iyzico und PayTR ist Craftgate kein einzelner Zahlungsdienstleister, sondern fungiert als eine übergeordnete Ebene, die mehrere Banken und Zahlungsanbieter über eine einzige Integration verwaltet. Dieser Unterschied bestimmt direkt, welcher Anbieter für welchen Shop die richtige Wahl ist.

Kriterium Craftgate iyzico PayTR
Modell Multi-Bank / Provider Routing-Schicht Einzelnes Zahlungsinstitut (Payment Facilitator) Einzelnes Zahlungsinstitut (Virtual-POS-Anbieter)
Shopify-App Craftgate Payment Gateway (App Store) Offizielle Shopify-Alternative mit verbreiteter Nutzung Offizielle PayTR-App, verbreitete Nutzung
Alternative Zahlungsmethoden Multinet, Edenred Geschenkkarte, GarantiPay, Worldpay Kreditkarte, Banküberweisung/EFT, Nachnahme (je nach Shop-Einstellung) Kreditkarte, Banküberweisung/EFT, Nachnahme (je nach Shop-Einstellung)
Bei Zahlungsausfall Automatische Weiterleitung über Smart Retry und Autopilot Einzelner Anbieter, manueller Eingriff Einzelner Anbieter, manueller Eingriff
Einrichtungsaufwand Mittel-hoch (erfordert Bank-Onboarding-Schritte) Gering (ein Konto, ein API-Schlüssel) Gering (ein Konto, ein API-Schlüssel)
Am besten geeignet für Volumenstarke Shops mit mehreren Bankverträgen Kleine bis mittelgroße Shops mit schnellem Setup Kleine bis mittelgroße Shops mit schnellem Setup

Unsere Beobachtungen bei Nodus Works zeigen, dass für einen Shop, der mit dem virtuellen POS einer einzigen Bank auskommt, die Multi-Routing-Ebene von Craftgate eine unnötige Komplexität darstellt; die einfache Integration von iyzico oder PayTR bedeutet für solche Shops einen deutlich geringeren Wartungsaufwand. Der wahre Mehrwert von Craftgate zeigt sich bei mittelgroßen bis großen Shops, die Verträge mit mehreren Banken haben und ihre Ablehnungsquoten bei Zahlungen senken möchten.

Häufige Fehler und wichtige Hinweise

Das häufigste Problem bei der Einrichtung von Craftgate ist das Überspringen des Sandbox-Tests zugunsten einer direkten Live-Schaltung; wenn das Zahlungsergebnis dann nicht im Shopify-Bestellbildschirm erscheint, müssen Sie die Fehlerquelle mühsam in der Live-Umgebung suchen.

Wichtiger Hinweis: Die Craftgate Payment Gateway-App weist im Shopify App Store seit ihrer Veröffentlichung im Jahr 2022 keine Bewertungen auf. Das bedeutet nicht, dass die App nicht funktioniert; es zeigt lediglich, dass Craftgate die Shopify-Integration direkt über die eigene Entwicklerdokumentation unterstützt und App-Store-Bewertungen keine Priorität einräumt. Bestätigen Sie die aktuellen Integrationsschritte vor Beginn der Einrichtung über den offiziellen Support-Kanal von Craftgate.

Ein zweiter häufiger Fehler besteht darin, die Routing-Regeln nach der Einrichtung mehrerer virtueller Bank-POS nicht zu testen. Wenn das intelligente Routing aktiv ist, wird nicht im Voraus festgelegt, welche Transaktion an welche Bank geht; daher reicht es nicht aus, mit einer Testbestellung mit geringem Betrag nur die Funktion einer einzigen Bank zu bestätigen – es sollten Testtransaktionen über mindestens zwei verschiedene virtuelle Bank-POS durchgeführt werden.

Tipp: Nachdem Sie die Funktion „Zahlungswiederholung“ (Payment Retry) aktiviert haben, sollten Sie unbedingt testen, wie viele Versuche dem Kunden gewährt werden und wie diese Versuche im Checkout-Bildschirm angezeigt werden. Wenn diese Einstellung auf dem Standardwert belassen wird, muss der Kunde seine Kartendaten möglicherweise mehrfach eingeben, was die Abbruchrate im Warenkorb erhöht.

Der dritte Punkt ist, dass es einen separaten Schritt zwischen der Aktivierung alternativer Zahlungsmethoden wie Multinet oder Edenred-Geschenkkarten im Craftgate-Panel und deren automatischer Anzeige im Shopify-Checkout gibt; eine im Panel aktivierte Methode erscheint erst dann auf dem Kundenbildschirm, wenn sie auch in den Shopify-Zahlungseinstellungen explizit aktiviert wurde.

FAQ: Shopify Craftgate-Integration

Wie wird Craftgate in Shopify eingerichtet? Nachdem Sie ein Konto bei Craftgate.io eröffnet und Ihre API-Schlüssel erhalten haben, installieren Sie das Craftgate Payment Gateway aus dem Shopify App Store und geben Sie die Schlüssel in den App-Einstellungen ein. Definieren Sie die angebundenen Banken und nehmen Sie die Live-Schaltung erst nach erfolgreichen Testtransaktionen in der Sandbox-Umgebung vor.

Ist Craftgate kostenlos? Die Shopify-App selbst ist kostenlos; die Kosten setzen sich aus den Provisionssätzen der von Ihnen angebundenen virtuellen Bank-POS sowie gegebenenfalls den eigenen Servicegebühren von Craftgate zusammen. Aktuelle Provisionsinformationen müssen Sie direkt beim Vertriebsteam von Craftgate erfragen, da diese Sätze von Shop zu Shop variieren.

Welche Banken funktionieren mit Craftgate? Craftgate bündelt die virtuellen POS der Banken, mit denen Sie Verträge haben, in einem einzigen Panel; welche Banken unterstützt werden, hängt von der aktuellen Bankenliste von Craftgate ab. Wenn Sie einen Vertrag mit einer neuen Bank abschließen, müssen Sie diese im Panel separat definieren.

Sollte man Craftgate oder PayTR bevorzugen? Für kleine bis mittelgroße Shops, bei denen der virtuelle POS einer einzigen Bank ausreicht, ist die einfache Integration von PayTR wartungsärmer. Für Shops, die Verträge mit mehreren Banken haben und ihre Ablehnungsquoten bei Zahlungen senken möchten, ist die Multi-Routing-Ebene von Craftgate besser geeignet.

Wie wird die Sandbox-Umgebung von Craftgate genutzt? Sie können über sandbox-panel.craftgate.io ein separates Testkonto eröffnen und Testbestellungen ohne echte Geldtransaktionen durchführen. Da Live-Kontodaten und Sandbox-Konten unabhängig voneinander sind, müssen Sie vor dem Live-Gang ein separates Konto in der Sandbox erstellen.

Fazit

Craftgate ist eine Middleware-Lösung für Shopify-Shops, denen die Einrichtung eines einzelnen virtuellen Bank-POS nicht ausreicht und die mehrere Zahlungsquellen verwalten möchten. Die Einrichtung erfordert zwar mehr Schritte als bei iyzico oder PayTR, bietet dafür jedoch automatische Routing- und Wiederholungsmechanismen, die die Ablehnungsquote bei Zahlungen senken.

Bevor Sie entscheiden, welcher Zahlungsanbieter für Ihren Shop geeignet ist, sollten Sie Ihre aktuelle Provisionsstruktur und Ihr Auftragsvolumen analysieren; wenn eine einzelne Bank ausreicht, ist der Einrichtungsaufwand für Craftgate unnötig. Für Shops, die die Zahlungsintegration zusammen mit anderen technischen Shopify-Komponenten (Versand, ERP, Buchhaltung) durchgängig einrichten möchten, bietet unser Shopify-Integrationsservice den gesamten Prozess von der Anbindung des virtuellen Bank-POS bis zur ERP-Synchronisation aus einer Hand. Weitere Zahlungsanbieter, die in der Türkei an Shopify angebunden werden können (Sipay, Paratika, Lidio), haben wir in unserem Leitfaden zur Shopify-Einrichtung für virtuelle POS-Systeme vergleichend untersucht.