Was ist die Shopify-iyzico-Integration und warum ist sie wichtig?
Die Shopify-iyzico-Integration ist eine technische Konfiguration, bei der die Zahlungsinfrastruktur von iyzico mit dem Shopify-Shop verbunden wird, damit Kunden per Kreditkarte, Debitkarte und in Raten bezahlen können. iyzico ist ein 2013 gegründeter Anbieter von Zahlungsinfrastruktur, der zur PayU-Gruppe gehört und mit einer Lizenz der TCMB (der türkischen Zentralbank) arbeitet. iyzico ist im offiziellen App Store von Shopify gelistet und eine der verbreitetsten Zahlungslösungen für Shopify-Shops in der Türkei.
Da PayPal und Stripe in der Türkei keine Dienste anbieten können, sind lokale Anbieter mit TCMB-Lizenz die einzige gangbare Option. Vor allem für neue Shops ist iyzico die bevorzugte Lösung, weil es eine direkte Integration mit Shopify bietet, alle großen Banken in der Türkei unterstützt und sich in 15 Minuten einrichten lässt. iyzico ist eine der in der Türkei genutzten Infrastrukturen für virtuelle POS-Terminals; die Einrichtung und den Vergleich aller Optionen, einschließlich der virtuellen POS-Terminals der Banken, behandeln wir separat in unserem Leitfaden zur Einrichtung eines virtuellen POS-Terminals in Shopify.
Einen Überblick über alle Zahlungsoptionen, die Sie mit Shopify in der Türkei nutzen können, finden Sie hier: Zahlungsmethoden in Shopify hinzufügen: Leitfaden für die Türkei
iyzico-Konto eröffnen: Voraussetzungen und Antragsverfahren
Für einen Antrag bei iyzico gibt es zwei Profile: Einzelperson (Einzelunternehmer) und Unternehmen (Gesellschaft). Beide eignen sich für die Shopify-Integration. Sollen über iyzico hinaus auch PayTR, Craftgate oder das virtuelle POS-Terminal einer Bank angebunden werden, richtet unser Service für Shopify-Integrationen die gesamte türkische Zahlungsinfrastruktur in einem einzigen Projekt ein.
Erforderliche Unterlagen für Einzelpersonen
- Türkische Identifikationsnummer (TC-Kimlik-Nr.)
- Aktives Bankkonto und IBAN
- Steuernummer (als steuerpflichtige Einzelperson)
- Kontaktdaten
Erforderliche Unterlagen für Unternehmen
- Steuerbescheinigung
- Unterschriftenzirkular der Zeichnungsberechtigten
- Veröffentlichung im türkischen Handelsregisterblatt
- IBAN des Firmenkontos
- Ausweisdokument der vertretungsberechtigten Person
Das Antragsverfahren läuft vollständig digital über iyzico.com und ist innerhalb von 2 bis 5 Werktagen abgeschlossen. Fehlen Unterlagen, informiert Sie das iyzico-Team per E-Mail oder Telefon.
Tipp: Um den Antrag zu beschleunigen, scannen Sie die Unterlagen vorab ein und legen Sie sie als PDF bereit. Bei schlechter Dokumentqualität oder fehlenden Unterlagen lehnt iyzico den Antrag ab, und Sie müssen das Verfahren neu beginnen.
Shopify-iyzico-Integration: Einrichtung Schritt für Schritt
Schritt 1: API-Daten im iyzico Merchant Panel abrufen
Sobald Ihr iyzico-Antrag genehmigt ist, melden Sie sich in Ihrem Panel unter merchant.iyzipay.com an. Gehen Sie im linken Menü zum Bereich Einstellungen. Unter „API-Schlüssel“ finden Sie zwei Angaben:
- API Key (API-Schlüssel des Händlers)
- Secret Key (geheimer Schlüssel)
Speichern Sie beide Angaben an einem sicheren Ort. Geben Sie den Secret Key niemals an Dritte weiter.
Wichtiger Hinweis: Das iyzico-Panel hat zwei getrennte Umgebungen: Sandbox (Test) und Live (Produktiv). Jede Umgebung hat eigene API-Schlüssel. Mit den Schlüsseln der Testumgebung lassen sich keine echten Zahlungen annehmen. Verwenden Sie bei der Integration zuerst die Sandbox-Schlüssel und wechseln Sie nach erfolgreichem Test zu den Live-Schlüsseln.
Schritt 2: Im Shopify Admin die Zahlungseinstellungen öffnen
Klicken Sie im Shopify Admin unten links auf Einstellungen (Settings). Wählen Sie im folgenden Menü den Bereich Zahlungen (Payments).
Schritt 3: iyzico als Drittanbieter hinzufügen
Klicken Sie auf Zahlungsmethode hinzufügen und geben Sie in der Suche nach Anbietern „iyzico“ ein. Wählen Sie iyzico aus den Ergebnissen, klicken Sie auf Aktivieren und danach auf Verbinden, und installieren Sie im folgenden Fenster die iyzico-App.
Schritt 4: API-Daten eingeben
Füllen Sie im Einrichtungsfenster von iyzico diese Felder aus:
- API Key: der Händler-API-Schlüssel, den Sie aus dem iyzico-Panel kopiert haben
- Secret Key: Ihr geheimer Schlüssel
- Aktivierung: Aktivieren Sie nach dem Speichern der Daten in Shopify die Zahlungsmethode „iyzico - Kredit- und Bankkarten“
Schritt 5: Testzahlung durchführen
Führen Sie in der Sandbox-Umgebung von iyzico eine Testzahlung durch. Die Testkartendaten finden Sie in der offiziellen Entwicklerdokumentation von iyzico. Ersetzen Sie nach erfolgreichem Test die Sandbox-Schlüssel durch den Live-API-Key und den Live-Secret-Key; ist der Testmodus aktiv, schalten Sie ihn aus.
Schritt 6: Ratenzahlungsoptionen konfigurieren
Im iyzico-Panel legen Sie unter Ratenzahlungseinstellungen fest, wie viele Raten Sie für welche Banken anbieten. Mit der Zahl der Raten steigt die Provision von iyzico; stimmen Sie das Verhältnis von Raten und Provision deshalb auf Ihre Produktmargen ab.
Provisionsstruktur von iyzico (2026)
iyzico berechnet eine Provision pro Transaktion. Eine feste Monatsgebühr fällt nicht an.
Hinweis: Die Provisionssätze hängen vom Transaktionsvolumen ab. Für Shops mit mehr als 20.000 TL Monatsumsatz bietet iyzico individuelle Konditionen an. Die aktuellen Sätze erfahren Sie direkt beim Vertriebsteam von iyzico.
Transaktionsgebühr von Shopify: Wenn Sie einen anderen Anbieter als die Shopify-eigene Zahlungsabwicklung nutzen, berechnet Shopify eine zusätzliche Transaktionsgebühr. Im Basic-Tarif sind es 2 %, im Grow-Tarif 1 %, im Advanced-Tarif 0,6 % und bei Plus 0,2 %. Bei der Berechnung der Gesamtkosten müssen Sie diese Gebühr zur iyzico-Provision addieren.
iyzico und PayTR im Vergleich
Bei Nodus Works beobachten wir, dass die einfache Einrichtung von iyzico für neue Shops mit geringem Transaktionsvolumen ein entscheidender Vorteil ist; bei Shops mit mehr als 200 Transaktionen im Monat führt der Provisionsunterschied von PayTR dagegen aufs Jahr gerechnet zu einer spürbaren Ersparnis.
Häufige Fehler und ihre Lösung
Fehler: Zahlungen schlagen fehl, Meldung „ungültiger API-Schlüssel“ Ursache: Sandbox- und Live-API-Schlüssel wurden verwechselt. Lösung: Prüfen Sie im iyzico-Panel, in welcher Umgebung Sie sich befinden. Verwenden Sie für den Live-Shop die Schlüssel der Live-Umgebung.
Fehler: Die 3D-Secure-Seite öffnet sich nicht Ursache: 3D Secure ist im iyzico-Konto nicht aktiviert. Lösung: Prüfen Sie im iyzico-Panel, ob die Einstellung „3D Secure“ aktiv ist.
Fehler: Ratenzahlungsoptionen erscheinen nicht im Checkout Ursache: Ihr Shopify-Tarif lässt nur begrenzte Anpassungen bei Ratenzahlungen zu, oder im iyzico-Panel sind keine Raten hinterlegt. Lösung: Aktivieren Sie im iyzico-Panel unter Ratenzahlungseinstellungen die Banken und die Zahl der Raten.
Fehler: Zahlung erfolgreich, aber keine Bestellung angelegt Ursache: Die Verbindung der iyzico-App mit Shopify ist nicht abgeschlossen oder die Zahlungsmethode nicht aktiviert; iyzico kann die Zahlungsbestätigung nicht an Shopify übermitteln. Lösung: Prüfen Sie unter Einstellungen > Zahlungen, ob die iyzico-App verbunden und die Methode „iyzico - Kredit- und Bankkarten“ aktiviert ist.
Internationaler Verkauf mit iyzico
iyzico akzeptiert Zahlungen mit ausländischen Kreditkarten; alle Transaktionen werden jedoch in Türkischer Lira (TRY) abgewickelt. Wie Sie Zahlungen in anderen Währungen annehmen und Kunden im Ausland lokale Zahlungsoptionen anbieten, erklärt unser Leitfaden zur Verwaltung von Zahlungsmethoden nach Märkten in Shopify.
Wie lässt sich der Ratenzahlungsaufschlag in der Shopify-Bestellung anzeigen?
Bei Shops, die in Shopify mit Ratenzahlung verkaufen, wird der über iyzico berechnete Ratenzahlungsaufschlag nicht automatisch in die Bestellung übernommen; der Bestellbetrag zeigt nur den Produktpreis. iyzico hat dieses Problem mit einer selbst entwickelten App gelöst: Es gibt eine kostenlose App, die den Ratenzahlungsaufschlag automatisch in die Bestelldetails im Admin einträgt. Ausführlich behandeln wir das Thema in einem eigenen Beitrag.
FAQ
Wie fügen Sie iyzico zu Shopify hinzu? Sie eröffnen ein Konto auf iyzico.com und erhalten die API-Schlüssel. Im Shopify Admin wählen Sie über Einstellungen, Zahlungen, Anbieter hinzufügen iyzico aus und geben die API-Daten ein. Ist die Testzahlung erfolgreich, wechseln Sie in den Live-Modus.
Wie hoch ist die Provision von iyzico bei Shopify? Laut der offiziellen Seite von iyzico zum virtuellen POS beginnt die Provision für Einmalzahlungen 2026 bei 4,29 % + 0,25 TL (inkl. BSMV) für Unternehmen und bei 4,49 % + 0,25 TL für Einzelpersonen. Bei Ratenzahlungen steigt dieser Satz mit der Zahl der Raten. Hinzu kommt die zusätzliche Transaktionsgebühr von Shopify.
Wie lange dauert ein iyzico-Antrag? Anträge von Einzelpersonen werden in der Regel innerhalb von 2-3 Werktagen entschieden, Anträge von Unternehmen innerhalb von 4-5 Werktagen. Wenn keine Unterlagen fehlen, kann es schneller gehen.
Ist Ratenzahlung mit iyzico möglich? Ja. iyzico erlaubt Ratenzahlungsoptionen für alle großen Banken in der Türkei. Zahl der Raten und Auswahl der Banken legen Sie im iyzico Merchant Panel fest.
Brauchen Sie für die Shopify-iyzico-Integration technisches Wissen? Nein. Die Einrichtungsschritte im Shopify Admin erfordern keine technischen Kenntnisse. Für Webhooks und weitergehende Anpassungen empfiehlt sich technische Unterstützung.
Wie richten Sie die Shopify-iyzico-Integration ein? Sie eröffnen ein iyzico-Konto und holen sich im Merchant Panel API Key und Secret Key. Im Shopify Admin wählen Sie unter Einstellungen, Zahlungen, Drittanbieter iyzico aus und geben die API-Daten ein. Nach dem Test in der Sandbox wechseln Sie mit den Live-Schlüsseln in den Live-Modus.
Ist iyzico mit Shopify kompatibel? Ja. iyzico steht in der offiziellen Integrationsliste von Shopify und ist die am häufigsten genutzte Zahlungsinfrastruktur für Shopify-Shops in der Türkei. Die Einrichtung erfolgt direkt im Shopify Admin.
Shopify mit iyzico oder PayTR: Was ist besser? Beide Anbieter sind zuverlässig. iyzico punktet mit einfacher Einrichtung, PayTR bietet niedrigere Provisionen. Für Shops mit geringem Volumen ist iyzico vorteilhafter, für Shops mit hohem Volumen PayTR.
Die Shopify-iyzico-Integration ist der schnellste Weg, die Zahlungsinfrastruktur für Ihren Shop in der Türkei aufzubauen. Wenn Sie alle Schritte vom Antrag bis zur API-Konfiguration korrekt befolgen, kann sie innerhalb von 1-2 Werktagen aktiv sein.
Wenn bei der Integration Probleme auftreten oder Sie sich zwischen iyzico und PayTR nicht entscheiden können, nutzen Sie unsere Services für Shopify-Integrationen. Alle Optionen für die Einrichtung des Zahlungssystems mit Shopify in der Türkei finden Sie in unserem Shopify-Leitfaden für die Türkei.
