Introduction
Shopify merchants operating in Turkey face a specific challenge: Shopify Payments is not currently available in the region. This requires store owners to rely on third-party providers to process transactions in Turkish Lira (TRY) and offer the local payment features that customers expect. Choosing between the primary options—specifically iyzico and PayTR—is the most important decision you will make for your checkout's performance.
To manage these local providers effectively, we developed HidePay on the Shopify App Store, an app that gives you control over which payment methods appear based on the customer’s location or cart contents. This ensures that your Turkish customers see local options like iyzico while international customers see gateways better suited for their regions.
In this article, we will break down the setup process for the most popular Turkish gateways, compare their features, and explain how to optimize your checkout to increase conversion rates. You will learn how to handle installments, navigate API integrations, and ensure your store remains compliant with local regulations.
Understanding the technical requirements of these gateways is the first step toward building a reliable, high-converting store in the Turkish market.
The Reality of Shopify Payments in Turkey
Shopify Payments provides a simplified experience in many countries, but it has not yet expanded its internal processing to Turkey. For a merchant in Istanbul or Ankara, this means the "native" checkout experience must be supplemented by a third-party gateway. Without a local provider, you cannot easily accept Turkish Lira or offer the "Taksit" (installment) options that are cultural staples of Turkish e-commerce.
Turkish consumers are highly accustomed to using credit cards from local banks like Garanti, İş Bankası, and Yapı Kredi. These cards often come with loyalty programs and installment capabilities. If your checkout only offers a generic international credit card field without recognizing these local programs, your abandonment rate will likely climb.
Because you are forced to use third-party providers, you must also consider the transaction fees. Shopify charges a small additional fee for using third-party gateways instead of Shopify Payments. This makes selecting a provider with competitive commission rates even more critical to protecting your margins.
In-Depth: PayTR Features and Setup
PayTR is one of the most widely used payment providers for Shopify in Turkey. It is known for its relatively fast approval process and its ability to handle both credit and debit card transactions securely. For many small-to-medium enterprises (SMEs), PayTR serves as a reliable entry point into the market.
Core Features of PayTR
The primary advantage of PayTR is its support for all major Turkish card families. This includes Bonus, Maximum, World, Axess, CardFinans, Advantage, and Paraf. When a customer enters their card details, PayTR identifies the bank and can automatically present the available installment options.
PayTR also offers 3D Secure processing as a standard feature. In Turkey, 3D Secure is not just a safety feature; it is often a customer expectation. Many local cardholders feel more comfortable receiving an SMS verification code before a transaction is finalized. PayTR manages this flow without requiring you to write custom code.
The Setup Process
To integrate PayTR with your Shopify store, you must first apply for an account on their official website. You will need to provide your Turkish tax identification number, company details, and bank account information. Once approved, the technical setup follows these general steps:
- Access API Credentials: Log in to your PayTR merchant panel to find your Merchant ID, Merchant Key, and Merchant Salt.
- Add Provider in Shopify: In your Shopify admin, navigate to the Payments section and look for the option to add a third-party provider. Search for PayTR.
- Enter Credentials: Copy and paste your API keys into the respective fields in Shopify.
- Configure Callback URLs: PayTR requires a specific URL to send transaction results back to your store. Ensure this is set correctly in the PayTR panel to prevent "pending" orders that have actually been paid.
What to do next:
- Verify your company documents are ready for upload to speed up approval.
- Request "Live" mode immediately after performing a successful test transaction.
- Check that your bank account is linked correctly for weekly or daily settlements.
Hide, sort, and rename Shopify payment methods using powerful conditions. Customize your checkout and control payment options with HidePay.
In-Depth: iyzico Features and Setup
iyzico, now part of the global PayU brand, is often viewed as the most "tech-forward" payment provider in Turkey. They provide a highly polished user experience and have invested heavily in consumer-facing features like iyzico Buyer Protection. This brand recognition can be a significant trust signal for your store.
Core Features of iyzico
One of the standout features of iyzico is the "iyzico checkout" form. This is a responsive, localized payment window that handles card validation in real-time. Like PayTR, it fully supports the Turkish installment system.
Additionally, iyzico offers a marketplace solution. If you are running a store where multiple vendors sell products, iyzico can handle the complex logic of splitting payments between the platform owner and the sub-merchants. For standard retail stores, their "Protected Shopping" badge is a valuable tool for reducing cart abandonment among first-time visitors.
The Setup Process
Integrating iyzico is straightforward because they are an official Shopify partner with a dedicated app/integration path.
- Create an iyzico Account: Complete the registration on the iyzico website. They typically review applications within 24 to 48 hours.
- Install the Integration: Use the Shopify "Third-party providers" menu to locate iyzico.
- API Sync: Input your API Key and Secret Key. These are found in the "Settings" section of your iyzico merchant dashboard.
- Test the Flow: iyzico provides a "sandbox" environment. Use their provided test card numbers to ensure the checkout successfully redirects and returns to the "Thank You" page.
Key Takeaway
iyzico is ideal for merchants who prioritize brand trust and a polished UI. While their commission rates might differ slightly from PayTR, the added layer of buyer protection can lead to higher conversion rates for premium brands.
The Critical Role of Installments (Taksit)
In the Turkish market, the ability to pay in installments is not a luxury; it is a fundamental requirement for high-ticket items. Whether you are selling electronics, furniture, or high-end fashion, customers expect to see a table showing how much they will pay over 3, 6, 9, or 12 months.
Both PayTR and iyzico handle the technical side of this. When a customer enters a valid Turkish credit card number at checkout, the gateway communicates with the bank to see which installment plans are active for that specific merchant category.
However, offering installments comes with a cost. The bank and the provider usually take a higher commission for installment transactions than for single-payment transactions. You must decide whether to:
- Absorb the cost to keep your prices competitive.
- Reflect the installment cost in the final price shown to the customer.
- Limit installments only to orders above a certain value.
Managing these options is where many merchants run into trouble. If you want to show installments for Turkish customers but hide them for international shoppers (to avoid confusion), you need a way to control your checkout logic dynamically.
Sorting and Hiding for Maximum Conversion
When you use multiple gateways, your Shopify checkout can quickly become cluttered. For example, if you offer iyzico for local customers and a different provider for international orders, both might show up for everyone by default. This creates friction.
We designed HidePay to solve this specific problem. If you have a Turkish store that also sells to Germany or the UK, you don't want your European customers seeing a Turkish-language payment gateway that they can't use. Using the app, you can create a rule that hides iyzico or PayTR whenever the customer's shipping address is outside of Turkey; see the help article on How to create a payment customization for step-by-step instructions.
Furthermore, you can use the tool to sort your payment methods. If you have negotiated a better commission rate with PayTR than with iyzico, you should place PayTR at the top of the list. By reordering your payment methods, you guide the customer toward the option that is most profitable for your business; the help guide on Sort and Rename payment methods in the Checkout explains how to reorder and rename options.
Strategic hiding also helps with risk management. If you notice a high rate of fraudulent orders from a specific region or for a specific product type, you can use our app to hide certain payment methods for those specific conditions. This keeps your checkout clean and your risk low.
Technical Pitfalls: API Keys and Test Modes
The transition from a development store to a live environment is where most technical errors occur. Turkish gateways are strict about security, and a single incorrect character in an API "Salt" or "Secret Key" will cause the entire checkout to fail.
Common Integration Errors
The most frequent issue is the "Hash Mismatch" error. This usually happens when the data sent from Shopify to the gateway (like the order total or currency) doesn't match what the gateway expects. This can occur if you have a currency converter app that changes the price at the last second, but the gateway is still trying to charge the original amount.
Another common pitfall is remaining in "Test Mode." Both PayTR and iyzico have a toggle in their dashboards. If you leave this on, customers will see a success message, but no money will be moved. Always perform a "live" transaction with a real card for a small amount to verify that the funds actually reach your merchant account.
If you need to confirm which payment method label to target in a rule (exact naming matters), see the troubleshooting article How to Retrieve the Correct Payment Method in HidePay.
Mobile-Friendliness
Over 70% of Turkish e-commerce traffic typically comes from mobile devices. Both iyzico and PayTR offer responsive payment pages, but you must ensure that your Shopify theme doesn't interfere with the redirect. If you use custom "sticky" add-to-cart buttons or checkout scripts, test them on multiple mobile browsers (Chrome, Safari, and the Instagram in-app browser) to ensure the payment window opens correctly.
Managing Cross-Border Transactions
If your store is based in Turkey but you are targeting a global audience, your payment strategy must be bifurcated. Local gateways are excellent for TRY transactions but may have lower success rates for international cards or may not support popular global methods like Apple Pay or PayPal.
In this scenario, many merchants use a combination of a Turkish gateway (like iyzico) and an international one. However, Shopify's default behavior is to list every active gateway. This can be confusing for a customer in New York who sees "iyzico" at the top of the list.
Our app allows you to segment your checkout perfectly. You can set a rule to:
- Show PayTR only when the currency is TRY or the country is Turkey.
- Show a different credit card provider when the currency is USD or EUR.
- Hide "Express Checkout" buttons (like PayPal) for Turkish customers, as PayPal does not currently operate in Turkey.
This level of precision ensures that no matter where your customer is located, they only see the options that are relevant, functional, and trusted in their specific region.
Strategic Use Cases for Payment Rules
Customizing your checkout isn't just about hiding gateways; it's about business logic. Here are three practical ways to use rules to improve your Turkish store's operations:
- Product-Based Rules: Some items might have higher shipping risks or lower margins. If you are selling a heavy item that is costly to ship, you might want to hide "Cash on Delivery" (if you offer it) and only allow secure credit card payments through iyzico; see Is it possibile to hide payment methods for certain products? for implementation details.
- Customer Tagging: If you have a VIP or Wholesale customer group, you can use our tool to show them specific payment methods that aren't available to the general public, such as bank transfers or specialized B2B gateways.
- Cart Total Thresholds: To minimize the impact of high transaction fees on very small orders, you could hide certain expensive gateways if the cart total is below a specific amount.
By applying these rules, you protect your margins while providing a tailored experience for different types of buyers.
Comparison: iyzico vs. PayTR
Choosing between these two depends on your specific business needs.
PayTR is often the choice for:
- High-volume merchants looking for aggressive commission rates.
- Stores that need a fast, no-frills approval process.
- Merchants who prefer a direct API-style integration that feels lightweight.
iyzico is often the choice for:
- Brands that want to leverage the "iyzico" name for customer trust.
- Merchants who value a more robust dashboard with advanced reporting.
- Stores that want to offer "Buyer Protection" as a marketing feature.
Regardless of which one you choose, both provide the essential "Taksit" infrastructure required to succeed in Turkish e-commerce. Many successful stores actually keep both active and use HidePay to sort them based on which one is performing better or offering lower fees at any given time.
If you want a walkthrough of why merchants combine payment and shipping rules, the Nextools post about HideSuite — the bundle for smart Shopify merchants explains the combined benefits of using HidePay with a shipping rules app.
FAQ
Is Shopify Payments available in Turkey?
No, Shopify Payments is not currently supported in Turkey. Merchants must use third-party providers such as iyzico, PayTR, or local bank virtual POS systems to accept payments and process transactions in Turkish Lira.
Can I offer installments (Taksit) on Shopify in Turkey?
Yes, you can offer installments by integrating a local provider like iyzico or PayTR. These gateways automatically detect Turkish credit cards and display the available installment plans from major banks directly on the payment page.
Do I need a Turkish business license to use PayTR or iyzico?
Generally, yes. To clear the "Know Your Customer" (KYC) requirements and have funds settled into a bank account, these providers require documentation showing you are a registered business or a sole proprietor in Turkey with a valid tax ID.
How do I hide Turkish payment methods for international customers?
Since Shopify doesn't do this natively, you can use HidePay to create a geography-based rule. See the HidePay help article How to create a payment customization to set up country-based conditions that hide specific gateways like iyzico or PayTR whenever the customer's shipping address is outside of Turkey.
Conclusion
Setting up a Shopify store in Turkey requires a strategic approach to payment processing. While the absence of Shopify Payments adds an extra step to your setup, local providers like iyzico and PayTR offer powerful features like installments and 3D Secure that are essential for the Turkish market. By integrating these gateways correctly and managing them with the right tools, you can create a checkout experience that feels local, trustworthy, and efficient.
To get the most out of your Turkish payment setup:
- Choose the provider that best fits your brand's trust requirements and margin goals.
- Ensure your API keys are correctly configured for live transactions.
- Use logic-based rules to show the right payment methods to the right customers.
If you are ready to take full control of your checkout and optimize how your Turkish and international gateways are displayed, install HidePay to begin building a more efficient payment experience today. For an overview of HidePay and related resources, visit the HidePay homepage or read the developer blog post introducing HidePay for Shopify.