Shopify-iyzico-Integration: Anleitung zur schrittweisen Einrichtung (2026)

Mit der Shopify-iyzico-Integration verbinden Sie die Zahlungsinfrastruktur von iyzico mit Ihrem Shop und nehmen Kredit-, Debitkarten- und Ratenzahlungen an. Eine Anleitung Schritt für Schritt.

Veröffentlicht 9 Min. Lesezeit

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, vollständige Anträge innerhalb von 24 Stunden entscheidet und die Einrichtung auf der Shopify-Seite keine technischen Kenntnisse erfordert. 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

Ein iyzico-Konto wird über das Antragsformular auf iyzico.com in drei Schritten eröffnet: Konto erstellen, Identität verifizieren und Vertrag bestätigen

Bei iyzico können Sie sich mit zwei Profilen bewerben: als Einzelperson oder als Unternehmen. Der Antrag als Einzelperson ohne Steuerregistrierung gilt allerdings nur für das Produkt iyzico Link; da Link keinen API-Schlüssel hat, lässt es sich nicht mit Shopify verbinden. Für die Shopify-Integration ist ein Antrag für den virtuellen POS nötig, und dafür genügt ein steuerlich registriertes Einzelunternehmen oder eine Kapitalgesellschaft. 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; Anträge mit vollständigen Angaben und Unterlagen werden laut iyzico innerhalb von 24 Stunden entschieden. Werden je nach Geschäftsmodell zusätzliche Unterlagen oder Angaben angefordert, kann es länger dauern. Fehlen Unterlagen, informiert Sie das iyzico-Team per E-Mail oder Telefon.

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

Schritt 1: API-Daten im iyzico Merchant Panel abrufen

Im iyzico-Panel unter Einstellungen > Firmeneinstellungen > API-Schlüssel werden API-Schlüssel und Sicherheitsschlüssel über „Anzeigen“ eingeblendet

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.

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

In Shopify wird unter Settings > Payments > Add payment method „iyzico - Kredi ve Banka Kartları“ ausgewählt und auf Install geklickt; danach öffnet sich die Eingabemaske für die API-Daten von iyzico

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

In der iyzico-Verbindungsmaske werden der aus dem iyzico-Panel kopierte API Key und Secret Key in die Felder eingefügt und mit „Verbinden“ gespeichert

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 - Kredi ve Banka Kartları“ (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.

TransaktionsartProvisionssatz (ca.)
Einmalzahlung (alle Banken)Händler mit Steuerregistrierung 4,29 % + 0,25 TL (inkl. BSMV, der türkischen Bank- und Versicherungssteuer); der Satz ab 4,49 % + 0,25 TL für Einzelpersonen ohne Unternehmen gilt nur für das Produkt Link, das sich nicht mit Shopify verbinden lässt
3 RatenSatz der Einmalzahlung (4,29 % + 0,25 TL) zuzüglich eines je nach Bank unterschiedlichen Ratenaufschlags; laut iyzico-Hilfecenter gibt es für Raten keinen einheitlichen Listensatz, der Abzug wird im Panel unter „Taksit ve Komisyon Yönetimi“ (Raten- und Provisionsverwaltung) berechnet (Oktober 2026)
6 Raten4,29 % + 0,25 TL zuzüglich eines je nach Bank unterschiedlichen Ratenaufschlags, der mit der Zahl der Raten steigt
9 Raten4,29 % + 0,25 TL zuzüglich eines je nach Bank unterschiedlichen Ratenaufschlags, der mit der Zahl der Raten steigt
12 Raten4,29 % + 0,25 TL zuzüglich eines je nach Bank unterschiedlichen Ratenaufschlags, der mit der Zahl der Raten steigt
Ausländische Karteniyzico veröffentlicht keinen eigenen Listensatz; für Zahlungen in Fremdwährung ist das Add-on Multi Currency für 99 TL pro Jahr nötig (Listenpreis Oktober 2026), Raten sind bei Fremdwährungszahlungen nicht möglich

‍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

iyzico und PayTR sind zwei gängige Zahlungsanbieter für Shopify; bei beiden werden Provision, Auszahlung und Ratenkonditionen per individuellem Angebot für die Marke festgelegt
MerkmaliyzicoPayTR
Gründungsjahr20132009
Provision bei Einmalzahlung4,29 % + 0,25 TL (Unternehmen, 2026)Ab 2,19 % (mit 7 Tagen Valuta; der genaue Satz wird per Angebot nach Transaktionsvolumen und Branche festgelegt, keine feste Gebühr pro Transaktion)
Shopify-IntegrationOffiziellOffiziell
EinrichtungsaufwandEinfachMittel
Dauer der Antragsprüfung24 Stunden (bei vollständigem Antrag)1-5 Werktage
Ausländische KartenJaJa
RatenzahlungAlle großen BankenAlle großen Banken
Kundensupport24/724/7

Für neue Shops mit geringem Transaktionsvolumen ist die einfache Einrichtung von iyzico ein entscheidender Vorteil; wenn Ihr Transaktionsvolumen wächst, holen Sie bei PayTR ein individuelles Provisionsangebot ein und vergleichen Sie die Gesamtkosten beider Anbieter.

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 - Kredi ve Banka Kartları“ aktiviert ist.

Internationaler Verkauf mit iyzico

iyzico akzeptiert Zahlungen mit ausländischen Kreditkarten. Standardmäßig wird in Türkischer Lira (TRY) abgerechnet; wenn Sie im iyzico-Kontrollpanel im Bereich Add-ons das kostenpflichtige Add-on Multi Currency (99 TL pro Jahr) aktivieren, können Sie Zahlungen mit Visa und Mastercard in USD, EUR, GBP, RUB, CHF und NOK annehmen. Zahlungen in Fremdwährung werden zum Kurs der türkischen Zentralbank am Transaktionstag in Türkische Lira umgerechnet und Ihrem Konto gutgeschrieben. 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?

Die Shopify-App von iyzico, iyzico Admin Metafields, schreibt den Ratenzuschlag der auf der Zahlungsseite gewählten Ratenzahlung nach Abschluss der Zahlung in die Bestelldetails; der Bestellbetrag bleibt so mit der Buchhaltung abgestimmt

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? Laut dem iyzico-Hilfecenter werden Anträge mit vollständigen Angaben und Unterlagen innerhalb von 24 Stunden entschieden. Werden je nach Geschäftsmodell zusätzliche Unterlagen oder Angaben angefordert, kann es länger dauern.

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 > Zahlungsmethode hinzufügen in der Suche nach Anbietern 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 und ist für Shops mit geringem Volumen ein praktischer Einstieg. Der von PayTR veröffentlichte Einstiegssatz (ab 2,19 % mit 7 Tagen Valuta) liegt unter dem Listensatz von iyzico; den genauen Satz legt PayTR jedoch per Angebot nach Transaktionsvolumen und Branche fest. Vergleichen Sie bei wachsendem Volumen das Angebot von PayTR mit iyzico.

‍

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 bei einem Antrag mit vollständigen Unterlagen nach der von iyzico genannten Prüfzeit von 24 Stunden 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.

Starten Sie Ihr nächstes Projekt mit Nodus Works

Scrollen —