---
title: "Shopify iyzico Integration: Step by Step Setup Guide"
description: "Shopify iyzico integration is a technical configuration that allows customers to make credit, debit, and installment payments by connecting the iyzico payment infrastructure to the Shopify store."
url: https://nodusworks.com/en/blog/shopify-iyzico-integration-step-by-step-setup-guide
markdown: https://nodusworks.com/en/blog/shopify-iyzico-integration-step-by-step-setup-guide.md
language: en
alternates:
  tr: https://nodusworks.com/blog/shopify-iyzico-entegrasyonu-kurulum-rehberi.md
  de: https://nodusworks.com/de/blog/shopify-iyzico-integration-anleitung-zur-schrittweisen-einrichtung.md
last_updated: 2026-04-09
type: article
published: 2026-04-09
author: "Efe Gündüz"
tags: ["Shopify", "Integration", "Payment Methods"]
publisher: "Nodus Works"
---

# Shopify iyzico Integration: Step by Step Setup Guide 2026

> Shopify iyzico integration is a technical configuration that allows customers to make credit, debit, and installment payments by connecting the iyzico payment infrastructure to the Shopify store.

## What Is Shopify iyzico Integration and Why Does It Matter?

Shopify iyzico integration is a technical configuration that connects the iyzico payment infrastructure to a Shopify store so that customers can pay by credit card, debit card and in installments. iyzico is a payment infrastructure provider founded in 2013 that operates under PayU with a license from TCMB (the Central Bank of the Republic of Turkey). Listed on Shopify's official App Store, iyzico is one of the most widely used payment solutions for Shopify stores in Turkey.

Since PayPal and Stripe cannot offer their services in Turkey, local providers licensed by TCMB are the only valid option. iyzico integrates directly with Shopify, supports all major banks in Turkey, decides complete applications within 24 hours and needs no technical knowledge for the setup on the Shopify side, which makes it the go-to solution for new stores in particular. iyzico is one of the virtual POS options used in Turkey; we cover the setup and comparison of every option, including bank virtual POS terminals, in our [Shopify virtual POS setup guide](https://nodusworks.com/en/blog/shopify-virtual-pos-setup-integration-guide-with-turkish-banks).

For an overview of all the payment options you can use with Shopify in Turkey: [Adding Shopify Payment Methods: Turkey Guide](https://nodusworks.com/en/blog/adding-shopify-payment-methods)

## Opening an iyzico Account: Requirements and Application Process

![An iyzico account is opened in three steps through the application form on iyzico.com: account creation, identity verification, and contract approval](https://nodusworks.com/m/3d234d9b02-1200.webp)

You can apply to iyzico with two profiles: individual or corporate. However, an individual application without a tax registration covers only the iyzico Link product; Link has no API key, so it can't be connected to Shopify. The Shopify integration requires a Virtual POS application, and a tax-registered sole proprietorship or a company is enough for that. If you also plan to connect PayTR, Craftgate or a bank virtual POS alongside iyzico, our [Shopify integration service](https://nodusworks.com/en/services/shopify-integration-solutions) sets up your entire Turkish payment infrastructure as a single project.

### Documents Required for an Individual Application

- Turkish national ID number
- An active bank account and IBAN
- Tax number (individual taxpayer)
- Contact details

### Documents Required for a Corporate Application

- Tax certificate
- Authorized signatory list (signature circular)
- Trade Registry Gazette
- IBAN of the company bank account
- ID document of the authorized person

The application is handled entirely online through iyzico.com; according to iyzico, applications with complete information and documents are concluded within 24 hours. If additional documents or information are requested based on your business model, this can take longer. If any documents are missing, the iyzico team will let you know by email or phone.

**Tip:** To speed up the application, scan your documents in advance and prepare them as PDFs. If document quality is poor or something is missing, iyzico rejects the application and you have to start the process again.

## Shopify iyzico Integration: Step-by-Step Setup

### Step 1: Get Your API Credentials from the iyzico Merchant Panel

![Settings > Company Settings > API Keys in the iyzico dashboard: the API Key and Security Key are revealed with "View"](https://nodusworks.com/m/39d2413493-1200.webp)

Once your iyzico application is approved, log in to your panel at merchant.iyzipay.com. Go to the **Settings** section in the left-hand menu. Under "API Keys" you will find two separate credentials:

- **API Key (Merchant API Key)**
- **Secret Key**

Store these two credentials somewhere safe. Never share your Secret Key with third parties.

**Critical Warning:** The iyzico panel has two separate environments: **Sandbox (Test)** and **Live**. Each environment has its own API keys, and you cannot take live payments with test environment keys. Use the Sandbox keys first during the integration, then switch to the Live keys once testing is successful.

### Step 2: Go to Payment Settings in Shopify Admin

In Shopify Admin, click **Settings** in the bottom-left corner. In the menu that opens, select **Payments**.

### Step 3: Add iyzico as a Third-Party Provider

![In Shopify, go to Settings > Payments > Add payment method, select "iyzico - Credit and Debit Cards," and click Install; iyzico's API credentials screen then opens](https://nodusworks.com/m/40c577d710-1200.webp)

Click the **Add payment methods** button and type "iyzico" into the search box to search by provider. Select iyzico from the results, click **Activate**, then **Connect**, and install the iyzico app from the screen that opens.

### Step 4: Enter Your API Credentials

![On the iyzico connection screen, the API Key and Secret Key copied from the iyzico dashboard are pasted into their fields and saved with "Connect"](https://nodusworks.com/m/756ade0d6f-1200.webp)

Fill in the following fields on the iyzico setup screen:

- **API Key:** The merchant API key you copied from the iyzico panel
- **Secret Key:** Your secret key
- **Activation:** After saving the details, activate the "iyzico - Kredi ve Banka Kartları" (credit and debit cards) payment method in Shopify

### Step 5: Run a Test Transaction

Make a test payment using the iyzico Sandbox environment. Use iyzico's official developer documentation for test card details. Once the test succeeds, replace the sandbox keys with your live API Key and Secret Key, and turn off test mode if it is on.

### Step 6: Configure Installment Options

In the **Installment Settings** section of the iyzico panel, you can decide how many installments to offer for which banks. iyzico's commission rate rises with the number of installments, so balance installments against commission according to your product margins.

## iyzico Commission Structure (2026)

iyzico charges a commission per transaction. There is no fixed monthly fee.

| Transaction Type           | Commission Rate (approximate)                                                                                                                                                                                                                                                                                  |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Single payment (all banks) | Tax-registered sellers 4.29% + 0.25 TL (BSMV, Turkey's banking transaction tax, included); the rate starting at 4.49% + 0.25 TL for individuals without a company applies only to the Link product, which can't connect to Shopify                                                                             |
| 3 installments             | Single-payment rate (4.29% + 0.25 TL) plus a bank-specific installment fee; per the [iyzico Help Center](https://www.iyzico.com/destek/yardim-merkezi), there is no single list rate for installments, and the deduction is calculated under Installment and Commission Management in the panel (October 2026) |
| 6 installments             | 4.29% + 0.25 TL plus a bank-specific installment fee that rises with the number of installments                                                                                                                                                                                                                |
| 9 installments             | 4.29% + 0.25 TL plus a bank-specific installment fee that rises with the number of installments                                                                                                                                                                                                                |
| 12 installments            | 4.29% + 0.25 TL plus a bank-specific installment fee that rises with the number of installments                                                                                                                                                                                                                |
| Foreign card               | iyzico doesn't publish a separate list rate; collecting in foreign currencies requires the Multi Currency add-on at 99 TL per year (October 2026 list price), and foreign-currency payments can't be split into installments                                                                                   |

**Note:** Commission rates vary with transaction volume. iyzico's published rate of 4.29% + 0.25 TL applies to monthly sales above 20,000 TL; at lower volumes, the rate may differ. Contact the iyzico sales team directly for current rates.

‍**Shopify Transaction Fee:** When you use a provider other than Shopify's own payment infrastructure, Shopify charges an additional transaction fee. The extra cost is 2% on the Basic plan, 1% on the Grow plan, 0.6% on the Advanced plan and 0.2% on the Plus plan. Add this fee to the iyzico commission when calculating your total cost.

## iyzico vs. PayTR

![iyzico and PayTR are two common payment providers that connect to Shopify; for both, commission, payout, and installment terms are set through a custom offer for each brand](https://nodusworks.com/m/bbb9586d22-1200.webp)

| Feature                   | iyzico                            | PayTR                                                                                                                                          |
| ------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Founded                   | 2013                              | 2009                                                                                                                                           |
| Single payment commission | 4.29% + 0.25 TL (corporate, 2026) | From 2.19% (with a 7-day payout; the exact rate is set in a quote based on transaction volume and industry, with no fixed per-transaction fee) |
| Shopify integration       | Official                          | Official                                                                                                                                       |
| Setup difficulty          | Easy                              | Moderate                                                                                                                                       |
| Application approval time | 24 hours (complete application)   | 1-5 business days                                                                                                                              |
| Foreign card support      | Yes                               | Yes                                                                                                                                            |
| Installment options       | All major banks                   | All major banks                                                                                                                                |
| Customer support          | 24/7                              | 24/7                                                                                                                                           |

For new stores with low transaction volumes, iyzico's easy setup is the deciding advantage; as your transaction volume grows, ask PayTR for a commission quote tailored to your business and compare the total cost of both providers.

## Common Errors and How to Fix Them

**Error: Payments fail with an "invalid API key" message** Cause: The Sandbox and Live API keys have been mixed up. Fix: Check which environment you are in on the iyzico panel. Use the Live environment keys for a live store.

**Error: The 3D Secure screen does not open** Cause: 3D Secure is not active on the iyzico account. Fix: Confirm that the "3D Secure" setting is active in the iyzico panel.

**Error: Installment options don't appear at checkout** Cause: Installment customization is limited on your Shopify plan, or no installments have been defined in the iyzico panel. Fix: Enable the banks and installment counts in the Installment Settings section of the iyzico panel.

**Error: The payment succeeds but no order is created** Cause: The iyzico app's connection to Shopify has not been completed or the payment method has not been activated, so iyzico cannot pass the payment confirmation on to Shopify. Fix: Under Settings > Payments, check that the iyzico app is connected and that the "iyzico - Kredi ve Banka Kartları" method is active.

## Selling Internationally with iyzico

iyzico accepts payments with foreign credit cards. Payments are collected in Turkish lira (TRY) by default; once you activate the paid Multi Currency add-on (99 TL per year) in the Add-ons section of the iyzico Control Panel, you can accept Visa and Mastercard payments in USD, EUR, GBP, RUB, CHF and NOK. Payments received in foreign currency are converted to Turkish lira at the Central Bank of the Republic of Turkey's exchange rate on the transaction date and transferred to your account. To accept payments in other currencies and offer local payment options to customers abroad, take a look at our guide to [market-based payment management in Shopify](https://nodusworks.com/en/blog/the-most-practical-way-to-manage-payment-methods-for-different-grocery-stores-in-shopify-hidepay).

## How to Show the Installment Interest Charge in a Shopify Order

![iyzico's Shopify app, iyzico Admin Metafields, writes the installment surcharge from the installment option chosen on the payment page to the order details after payment is complete; the order total stays consistent with accounting records](https://nodusworks.com/m/23ad382e47-1200.webp)

In Shopify stores that sell in installments, the installment interest charged through iyzico is not automatically reflected in the order record; the order total only shows the product price. iyzico has solved this problem with an app of its own: [a free app that automatically adds the installment interest](https://nodusworks.com/en/blog/how-to-display-interest-rate-in-shopify-order-record) to the order details in the admin. We cover that topic in detail in a separate article.

## FAQ

**How do I add iyzico to Shopify?** Open an account at iyzico.com and get your API keys. In Shopify Admin, go to Settings, Payments, Add provider, select iyzico and enter your API credentials. If the test transaction succeeds, switch to live mode.

**What is iyzico's commission rate on Shopify?** According to iyzico's official virtual POS page, the single-payment commission in 2026 starts at 4.29% + 0.25 TL (BSMV included) for corporate sellers and 4.49% + 0.25 TL for individual sellers. For installment transactions, the rate rises with the number of installments. Shopify's additional transaction fee is also added to the total cost.

**How long does an iyzico application take?** According to the iyzico Help Center, applications with complete information and documents are concluded within 24 hours. If additional documents or information are requested based on your business model, it can take longer.

**Can I offer installments with iyzico?** Yes. iyzico lets you define installments for all major banks in Turkey. The number of installments and the choice of banks are set in the iyzico merchant panel.

**Does the Shopify iyzico integration require technical knowledge?** No. The setup steps in Shopify Admin don't require technical knowledge. For webhooks and advanced customization, getting technical support is recommended.

**How do I set up the Shopify iyzico integration?** Open an iyzico account and get your API Key and Secret Key from the merchant panel. In Shopify Admin, go to Settings > Payments > Add payment methods, search by provider for iyzico, select it, and enter your API credentials. After testing in the Sandbox environment, switch to Live mode with your live keys.

**Is iyzico compatible with Shopify?** Yes. iyzico is on Shopify's official integration list and is the most widely used payment infrastructure for Shopify stores in Turkey. Setup is done directly in Shopify Admin.

**Shopify iyzico or PayTR: which is better?** Both providers are reliable. iyzico stands out for its easy setup and is a practical starting point for low-volume stores. PayTR's published starting rate (from 2.19% with a 7-day payout) is lower than iyzico's list rate, but PayTR sets the exact rate in a quote based on transaction volume and industry. As your volume grows, compare PayTR's quote with iyzico.

‍

Shopify iyzico integration is the fastest way to set up the payment infrastructure for your store in Turkey. If you follow every step correctly, from the application to the API configuration, an application with complete documents can be live once iyzico's stated 24-hour approval period has passed.

If you run into problems during the integration or find it hard to choose between iyzico and PayTR, you can make use of [our Shopify integration services](https://nodusworks.com/en/services/shopify-integration-solutions). For every option for setting up payments for a Shopify store in Turkey, take a look at our [Shopify Turkey guide](https://nodusworks.com/en/blog/shopify-turkey-guide-payment-shipping-legal-requirements-and-setup-2026).

---

Source: [Shopify iyzico Integration: Step by Step Setup Guide 2026 · Nodus Works](https://nodusworks.com/en/blog/shopify-iyzico-integration-step-by-step-setup-guide)  
Full content index: https://nodusworks.com/llms.txt  
MCP server for AI agents: https://nodusworks.com/en/ai-mcp
