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 and can be set up within 15 minutes, 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
There are two profiles you can apply with at iyzico: individual (sole trader) and corporate (company). Both work with the Shopify integration. 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 and is concluded within 2 to 5 business days. 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
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 - 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.
Note: Commission rates vary with transaction volume. iyzico offers special rates to stores with monthly sales above 20,000 TL. 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
At Nodus Works, we have seen that for new stores with low transaction volumes, iyzico's easy setup is the deciding advantage; for stores processing more than 200 transactions a month, the difference in PayTR's commission rate adds up to meaningful savings over a year.
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 - Credit and Debit Cards" method is active.
Selling Internationally with iyzico
iyzico accepts payments with foreign credit cards, but all transactions are processed in Turkish lira (TRY). 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? Individual applications are usually concluded within 2-3 business days and corporate applications within 4-5. If no documents are missing, the process can be shorter.
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, select iyzico under Settings, Payments, Third-party providers 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, while PayTR offers a lower commission rate. iyzico is the better fit for low-volume stores, PayTR for high-volume stores.
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, it can be live within 1-2 business days.
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.
