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.
Author: Efe Gündüz Nodus Works Shopify Agency Founder Published 10 min read
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.
For an overview of all the payment options you can use with Shopify in Turkey: Adding Shopify Payment Methods: Turkey Guide
Opening an iyzico Account: Requirements and Application Process
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 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.
Shopify iyzico Integration: Step-by-Step Setup
Step 1: Get Your API Credentials from the iyzico Merchant Panel

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

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

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, 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 |
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
| 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.
How to Show the Installment Interest Charge in a Shopify Order
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 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. For every option for setting up payments for a Shopify store in Turkey, take a look at our Shopify Turkey guide.