What is Shopify iyzico Integration and Why Is It Important
Shopify iyzico integration is a technical configuration that allows customers to pay by credit card, debit card, and installment payments by connecting to the Shopify store. iyzico is a payment infrastructure provider founded in 2013 and operating under a BDDK license under PayU. Located on Shopify's official App Store, iyzico is one of the most common payment solutions for Shopify stores in Turkey.
Since PayPal and Stripe cannot provide services in Turkey, BDDK certified local providers are the only viable option. iyzico is the preferred solution especially for beginner stores as it offers direct integration with Shopify, supports all major banks in Turkey, and can be set up in 15 minutes.
For an overview of all the payment options available in Shopify Turkey: Adding Shopify Payment Methods: Turkey Guide
Opening an iyzico Account: Requirements and Application Process
There are two different profiles to apply to iyzico: individual (individual) and corporate (company). Both are compatible with Shopify integration.
Documents Required for Individual Application
- TC identification number
- Active bank account and IBAN
- Tax number (individual taxpayer)
- Contact information
Documents Required for Corporate Application
- Tax sheet
- Signature Circles
- Trade register newspaper
- Company bank account IBAN information
- Authorized person's identity document
The application process is carried out completely digitally through iyzico.com and is concluded within 2 to 5 business days. In case of missing documents, iyzico team notifies via email or phone.
Hint: Prepare documents in PDF format by scanning them from scratch to speed up the application process. iyzico rejects the application when the document quality is poor or incomplete and you need to restart the process.
Shopify iyzico Integration: Step by Step Setup
Step 1: Get API Information from iyzico Merchant Panel
Once your iyzico application has been approved, log in to your panel at merchant.iyzipay.com On the left menu Settings Go to the section. Under “API Keys” there are two different types of information:
- API Key (Merchant API Key)
- Secret Key
Save these two pieces of information in a safe place. Never share the Secret Key with third parties.
Critical Warning: There are two separate media in the iyzico panel: Sandbox (Test) and Live (Live). Each environment has separate API keys. Live payment cannot be received with test environment keys. Use Sandbox keys first during integration; switch to Live keys after the test is successful.
Step 2: Go to Payment Settings in Shopify Admin
In the Shopify Admin panel in the lower left corner Settings Click on the option. In the drop-down menu Payments Select the section.
Step 3: Add iyzico as Third Party Provider
In the section “Accepted payment methods” Add Provider Click on the button. In the list that opens, type “iyzico” in the search box and select iyzico from the results.
Step 4: Enter API Information
On the iyzico installation screen, fill in the following fields:
- API Key: The merchant API key you copied from the iyzico panel
- Secret Key: Your secret key
- Base URL: https://sandbox-api.iyzipay.com for sandbox, https://api.iyzipay.com for live use
Step 5: Perform the Test Process
Perform test payment using iyzico Sandbox environment. Use iyzico's official developer documentation for test card information. After successful testing, switch the payment method to “Live” mode in Shopify Admin and update the Base URL to https://api.iyzipay.com.
Step 6: Configure Installment Options
in iyzico panel Installment Settings from the section you can determine how many installments for which banks you will offer. Based on the number of installments, izico's commission rate increases, so adjust the installment-commission balance to your product margins.
iyzico Commission Structure (2026)
iyzico takes transaction-based commissions. It does not apply a fixed monthly fee.
Nota: Commission rates vary depending on the volume of transactions. iyzico offers special rate offers for stores with a turnover of over $50,000 per month. Contact iyzico sales team directly for current rate information.
Shopify Transaction Fee: Shopify charges additional transaction fees when you use a provider other than its own payment infrastructure. Additional costs are 2% on the Basic plan, 1% on the Shopify plan, and 0.5% on the Advanced plan. When calculating the total cost, this fee should be added to the iyzico commission.
Compare iyzico to PayTR
At Nodus Works, we have observed that the ease of installation of izico is a decisive advantage for new stores with low transaction volumes, while for stores with more than 200 transactions per month, the difference in the commission rate of PAYTR provides significant savings on an annual basis.
Common Errors and Solutions
Error: Unable to receive payment, “invalid API key” error Cause: Sandbox and Live API keys mixed up. Solution: check what environment you are in in the iyzico panel. Use the keys to the Live environment for the live store.
Error: 3D Secure screen won't open Cause: Base URL was entered incorrectly or 3D Secure is not active on iyzico account. Solution: Verify that the “3D Secure” setting is active in the iyzico panel. Make sure the base URL is https://api.iyzipay.com.
Error: Installment options do not appear in checkout Cause: Installment customization is limited on the Shopify plan, or installments are not defined in the iyzico panel. Solution: Enable banks and installment numbers from the Installment Settings section in the iyzico panel.
Error: Payment is successful but order does not occur Cause: Webhook URL is not configured correctly; iyzico is unable to forward payment confirmation to Shopify. Solution: Enter the webhook URL of your Shopify store in the “Notification URL” field of the iyzico panel.
International Sales with iyzico
iyzico supports receiving payments with foreign credit cards, but all transactions take place in Turkish Lira (TRY). To receive payments in different currencies and offer local payment options to overseas customers Grocery based payment management on Shopify check out our guide.
FAQ: Shopify iyzico Integration
How to add iyzico to Shopify? An account is opened from iyzico.com and the API keys are retrieved. In the Shopify admin, select iyzico with the Settings, Payments, Add Provider steps and enter the API information. If the test process is successful, the live mode is switched to.
What is iyzico's commission rate on Shopify? As of 2026, iyzico charges about 2.85% + $0.35 commission for single withdrawal transactions. In installment transactions, this rate increases according to the number of installments. Shopify's additional transaction fee is also added to the total cost.
How long does it take to apply for iyzico? Individual applications are usually concluded within 2-3 business days, and corporate applications within 4-5 business days. If there is no lack of documents, the process may be shorter.
Is it possible to pay installments with iyzico? Yes. iyzico allows installment identification for all major banks in Turkey. The number of installments and the bank selection are set from the iyzico merchant panel.
Do you need technical knowledge in Shopify iyzico integration? No. Setup steps on Shopify Admin do not require technical knowledge. It is recommended that you get technical support for webhooks and advanced customizations.
How to integrate with Shopify iyzico iyzico account is opened, API Key and Secret Key are taken from merchant panel. In the Shopify admin, select iyzico from Settings, Payments, Third-party providers, and enter API information. After testing in a sandbox environment, you switch to Live mode with 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. Installation is done directly through Shopify Admin.
Which is better than Shopify iyzico or PayTR? Both providers are reliable. PayTR offers a lower commission rate while iyzico stands out for its ease of setup. For low volume stores, iyzico is more advantageous, and for high volume stores PayTR is more advantageous.
Shopify iyzico integration is the fastest way to set up the payment infrastructure for your store in Turkey. All steps from the application process to API configuration can be activated within 1-2 business days when followed correctly.
If you encounter problems during integration or have difficulty deciding between iyzico and PayTR From our Shopify integration services You can take advantage of it. For all options for setting up Shopify UK payment system To our Shopify Turkey directory browse.
