Die Shopify Craftgate Integration richten Sie in sechs Schritten ein: Craftgate-Konto eröffnen und API-Schlüssel abrufen, die Craftgate-App aus dem Shopify App Store installieren, Banken und virtuelle POS definieren, das Zahlungserlebnis wählen, in der Sandbox testen und live gehen. Craftgate ist eine Plattform zur Zahlungsorchestrierung: Sie wickelt selbst keine Zahlungen ab, sondern bündelt die virtuellen POS Ihrer Vertragsbanken.
In den von uns betreuten Shopify-Projekten sind wir bei Shops mit mehreren Bankverträgen immer wieder auf dasselbe Problem gestoßen: Hängt der Shop am virtuellen POS einer einzigen Bank, steht der Verkauf komplett still, sobald diese Bank Zahlungen vorübergehend ablehnt. Craftgate ist eine Shopify-Zahlungsintegration, die genau dieses Risiko verteilt. Als Plattform zur Zahlungsorchestrierung bündelt Craftgate die virtuellen POS verschiedener Banken sowie alternative Zahlungsmethoden in einem einzigen Dashboard. Statt sich auf einen einzelnen Zahlungsanbieter wie iyzico oder PayTR zu verlassen, verwalten Sie so mehrere Bankverträge Ihres Shops über eine einzige Integration.
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 und alternativen Zahlungsmethoden verknüpft. Nach eigener Darstellung ermöglicht Craftgate die Verwaltung mehrerer Anbieter über eine einzige Infrastruktur, sodass Sie nicht mit jedem Zahlungsdienstleister oder jeder Bank eine eigene Integration aufbauen müssen.
Laut einer Meldung von Fintechistanbul.org wurde die Zusammenarbeit zwischen Craftgate und Shopify 2022 offiziell, und die App Craftgate Payment Gateway kam in den Shopify App Store. 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.
Drei technische Merkmale unterscheiden die Shopify-Integration von Craftgate von Lösungen mit nur einem Zahlungsdienstleister:
- Echtzeit-Synchronisierung: Das Zahlungsergebnis erscheint sofort nach Abschluss des Vorgangs in der Bestellansicht von Shopify; 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, welcher virtuelle POS welcher Bank für die jeweilige Transaktion genutzt wird, basierend auf Kriterien wie Transaktionsbetrag, Kartentyp oder Erfolgsquote.
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 einen virtuellen POS: Abgefragt werden nicht nur Informationen zu einer Bank, sondern zu allen Banken, mit denen Ihr Shop zusammenarbeitet. Nach der Genehmigung erhalten Sie im Craftgate-Dashboard ein Paar aus API Key und Secret Key; diese Schlüssel brauchen Sie bei der Einrichtung der App in Shopify.
Klären Sie schon im Antragsprozess, in welcher Reihenfolge die Banken angelegt werden. Wenn Sie mehrere Bankverträge haben, besprechen Sie vorab mit dem Vertriebsteam von Craftgate, ob sie auf einmal oder schrittweise hinzugefügt werden, damit es bei der Einrichtung nicht zu Verwirrung kommt.
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 Test der App aus dem Shopify App Store in der Live-Umgebung; dazwischen legen Sie die angebundenen Banken an und wählen das Zahlungserlebnis.
Schritt 1: Craftgate-Konto eröffnen und API-Schlüssel abrufen
Schließen Sie den im vorherigen Abschnitt beschriebenen Antragsprozess ab und rufen Sie Ihre API-Schlüssel im Craftgate-Panel ab. Ohne diese Schlüssel lässt sich die App in Shopify nicht mit Ihrem Konto verknüpfen.
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 deren virtuellen POS in diesem Schritt ebenfalls 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 mit Ihrem Sandbox-Konto eine Testbestellung durch, ohne dass echtes Geld fließt. Prüfen Sie, ob das Zahlungsergebnis korrekt und in Echtzeit in der Bestellansicht von Shopify erscheint; überspringen Sie diesen Schritt, bemerken Sie 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
Craftgate unterscheidet sich von einer Einrichtung mit dem virtuellen POS einer einzigen Bank vor allem dadurch, dass Sie mehrere Zahlungsquellen über ein einziges Panel verwalten und Transaktionen automatisch zwischen ihnen weiterleiten können.
Bei Nodus Works sehen wir bei Shops, die mit mehreren Zahlungsanbietern arbeiten, immer wieder dasselbe Problem: Fällt ein Anbieter aus, steht der Verkauf komplett still. Die automatische Weiterleitungslogik von Craftgate löst dieses Risiko aus der Abhängigkeit von einem einzigen Anbieter und verteilt es. Das erhöht allerdings auch die Komplexität der Einrichtung; für kleine Shops, denen eine einzige Bank genügt, kann Craftgate deshalb eine unnötige zusätzliche Ebene sein.
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.
In den Projekten, die wir bei Nodus Works betreuen, sehen wir: Kommt ein Shop mit dem virtuellen POS einer einzigen Bank aus, fügt die Multi-Routing-Ebene von Craftgate unnötige Komplexität hinzu; die einfache Integration von iyzico oder PayTR bedeutet für einen solchen Shop weniger Wartungsaufwand. Seinen eigentlichen Mehrwert entfaltet Craftgate bei mittelgroßen bis großen Shops, die Verträge mit mehreren Banken haben und ihre Ablehnungsquote bei Zahlungen senken möchten.
Häufige Fehler und wichtige Hinweise
Der häufigste Fehler bei der Einrichtung von Craftgate: Der Sandbox-Test wird übersprungen und der Shop direkt live geschaltet. Erscheint das Zahlungsergebnis dann nicht in der Bestellansicht von Shopify, müssen Sie die Fehlerquelle mühsam in der Live-Umgebung suchen.
Ein zweiter häufiger Fehler: Nach der Einrichtung mehrerer virtueller POS verschiedener Banken werden die Routing-Regeln nicht getestet. Ist das intelligente Routing aktiv, steht nicht im Voraus fest, welche Transaktion an welche Bank geht. Es reicht deshalb nicht, mit einer kleinen Testbestellung nur eine einzige Bank zu prüfen; führen Sie Testtransaktionen über mindestens zwei verschiedene virtuelle POS durch.
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.
Drittens: Zwischen der Aktivierung alternativer Zahlungsmethoden wie Multinet oder Edenred-Geschenkkarten im Craftgate-Panel und ihrer Anzeige im Shopify-Checkout liegt ein eigener Schritt. Eine im Panel aktivierte Methode sieht der Kunde erst, wenn Sie sie auch in den Shopify-Zahlungseinstellungen ausdrücklich aktiviert haben.
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.
