Shopify Turkey Payment Gateways: Managing iyzico and PayTR

Introduction

Turkish e-commerce merchants must navigate a unique financial landscape because Shopify Payments is not available in the region. To accept payments, store owners must integrate third-party providers that support local credit cards and the specific "installment" culture prevalent in Turkey. Choosing between iyzico and PayTR is often the first major decision a merchant makes when launching a store in this market.

We understand that managing multiple payment options can clutter the checkout and confuse customers. While both iyzico and PayTR offer robust solutions, your checkout strategy needs more than just a functional connection. Using [HidePay on the Shopify App Store](HidePay: Hide Payment Methods) , merchants can gain granular control over how these gateways appear to different customer segments, ensuring that the right payment method is shown at the right time.

This article explores the technical and strategic aspects of setting up iyzico and PayTR on Shopify. We will cover the differences between these gateways, the importance of installment options, and how to optimize your checkout to increase conversion rates. Whether you are a local Turkish brand or an international merchant expanding into the region, this guide provides the practical steps needed to succeed.

Managing your checkout effectively is the difference between a high-abandonment rate and a loyal customer base.

The Reality of Shopify Payments in Turkey

Shopify provides a world-class platform for commerce, but its internal payment processing system, Shopify Payments, has not yet launched in Turkey. This means Turkish merchants cannot simply toggle a switch to begin accepting credit cards. Instead, you must rely on the "Third-Party Providers" or "Alternative Payment Methods" sections within your Shopify admin.

The absence of a native Shopify gateway creates a reliance on local providers who understand Turkish banking regulations and consumer behavior. Turkey has a highly developed banking sector with specific features like "Taksit" (installments). Local shoppers expect to see these options at checkout. If a store only offers a single, non-installment payment method, conversion rates often drop significantly.

Because you are forced to use third-party integrations, you may find that the checkout looks different than a standard Shopify Payments setup. Most Turkish gateways use a redirection model or a specific iframe. This makes the user experience slightly different, and managing these differences is key to maintaining trust with your audience.

Comparing iyzico and PayTR

When evaluating shopify turkey payment gateways, iyzico and PayTR are the two most common choices. Both are reputable, secure, and widely used, but they cater to slightly different merchant needs.

Understanding iyzico

iyzico, owned by PayU, is one of the most recognized payment brands in Turkey. It is known for its high security standards and "iyzico Buyer Protection." This feature is particularly valuable for newer stores that have not yet built a long-standing reputation. When customers see the iyzico logo, they often feel more secure completing a high-value purchase.

The platform provides a smooth integration with Shopify via a dedicated app or manual API connection. It supports all major Turkish card families, including Bonus, World, Maximum, Axess, Paraf, CardFinans, and Advantage. One of its strongest selling points is the "iyzipay" checkout experience, which minimizes friction and handles installment calculations automatically.

Understanding PayTR

PayTR is frequently cited by merchants for its competitive commission rates and rapid approval process. For a small business or a startup looking to go live within 24 hours, PayTR is often the faster route. They provide a highly stable infrastructure that handles large volumes of transactions without downtime.

PayTR also excels in its technical support and documentation. While iyzico focuses heavily on the consumer-facing brand, PayTR focuses on the merchant’s bottom line. Their dashboard provides detailed reporting on successful and failed transactions, helping you identify why a specific payment might have been declined by a local bank.

Feature Comparison

Feature	iyzico	PayTR
Setup Time	1-3 Business Days	Often under 24 hours
Installment Support	Comprehensive	Comprehensive
International Cards	Supported	Supported
Consumer Brand Recognition	Very High	High
Commission Rates	Competitive	Generally lower for high volume

The Importance of Installments (Taksit)

In the Turkish market, the ability to pay in installments is not just a luxury; it is a standard expectation. Most Turkish credit cards are linked to specific bank programs that allow a purchase to be split into 2, 3, 6, 9, or 12 months.

When you integrate a gateway like iyzico or PayTR, the installment table usually appears once the customer enters a valid Turkish credit card number. The gateway identifies the bank and the card type (e.g., a Garanti BBVA Bonus card) and displays the available monthly payment options.

If your store sells high-ticket items, such as furniture or electronics, failing to offer installments will lead to immediate cart abandonment. Merchants should ensure that their chosen gateway is correctly configured to show these options. Often, you can even rename the payment method in your Shopify settings to something like "Credit Card / Installment Options" to signal to the customer that these choices are available before they even enter their card details.

Technical Setup: Connecting Your Gateway

Integrating these gateways into your Shopify store is a multi-step process that requires attention to detail. While specific UI paths in the Shopify admin may change, the conceptual steps remain consistent.

Step 1: Account Application

Before doing anything in Shopify, you must have an approved account with your chosen provider. This involves submitting official business documentation, such as your tax plate (Vergi Levhası), trade registry gazette, and authorized signature circular. Both providers will also review your website to ensure you have clear Refund, Privacy, and Shipping policies in place.

Step 2: API Configuration

Once approved, you will receive an API Key and a Secret Key (or Merchant ID). In your Shopify admin, you will navigate to the Payments section and select your provider. You will then enter these credentials to link your store to the payment processor.

Step 3: Testing Mode

It is a common mistake to go live without testing. Most gateways provide a "Test Mode" or "Sandbox" environment. Use a test card provided by the gateway's documentation to simulate a successful transaction and a failed transaction. This ensures that when a real customer arrives, the redirection and order creation logic work as intended.

Step 4: Finalizing Redirection Settings

Most Turkish gateways redirect the customer to a secure page to complete the payment. Ensure that your "Return URL" is correctly configured so that after a successful payment, the customer is sent back to your "Thank You" page on Shopify. If this link is broken, the customer might pay the money, but Shopify will never receive the signal to create the order.

Optimizing Checkout with Rule-Based Logic

Simply having a payment gateway is not enough for a sophisticated store. You may find yourself in situations where you want to show different payment options based on who is buying or what they are buying. This is where [HidePay — free to install](HidePay: Hide Payment Methods) provides a significant advantage for Turkish merchants.

Hiding Gateways by Geography

If you sell both in Turkey and internationally, you might use PayTR for local TRY (Turkish Lira) transactions and a different gateway for USD or EUR transactions. It confuses international customers to see a Turkish-specific gateway that mentions local installments they cannot use. We recommend setting a rule to hide Turkish gateways for any customer located outside of Turkey; see the help article on [how to create a payment customization](How to create a payment customization) for step-by-step instructions.

Sorting for Better Conversion

If you have found that iyzico converts better for your audience than a standard bank virtual POS, you should ensure it appears first in the list. HidePay allows you to reorder your payment methods. By placing your most trusted and highest-converting gateway at the top, you reduce the cognitive load on the shopper, making it easier for them to click "Complete Purchase." Learn how to [sort and rename payment methods in the checkout](Sort and Rename payment methods in the Checkout).

Renaming for Clarity

The default names for third-party gateways can sometimes be generic or confusing. You can use our tool to rename "PayTR Virtual POS" to something more descriptive like "Pay with Credit Card (Up to 12 Installments)." This small change in labeling can have a measurable impact on trust and click-through rates at the final stage of the checkout.

Blocking Express Buttons

Shopify often pushes express checkout buttons like Apple Pay or PayPal. However, PayPal is not currently operational for domestic transactions in Turkey. Showing a PayPal button to a Turkish customer is a recipe for a failed transaction. You can use rules to block these specific express buttons based on the customer's shipping address, preventing them from attempting a payment method that will inevitably fail; follow the guide on [how to hide the Express Checkout with HidePay](Hide the Express Checkout with HidePay) for details.

Handling Multi-Currency and International Sales

Many Turkish merchants use Shopify to reach a global audience. This adds a layer of complexity to payment management. Turkish gateways are excellent for TRY transactions, but they may have higher fees or lower authorization rates for international cards from the US or Europe.

If you have an international business entity, you might choose to use a gateway like Stripe for your global customers while keeping PayTR for your local Turkish customers. Managing this manually in Shopify is impossible. However, by using native Shopify Functions, our app can detect the customer's currency or country and instantly adjust the available payment list.

For example, if the cart currency is USD, you can hide all Turkish-specific gateways and show only your international options. If the currency is TRY, you flip the logic. This ensures that you are always protecting your margins by using the most cost-effective gateway for every specific transaction; learn more about why HidePay uses native functions in the help article [Do I need Shopify Plus to modify the checkout?](Do I need Shopify Plus to modify the checkout)

Protecting Your Margins and Reducing Risk

Every payment method comes with a cost. This includes transaction fees, monthly maintenance fees, and the risk of chargebacks. In Turkey, "Cash on Delivery" (Kapıda Ödeme) is still a popular request, but it carries a high risk for the merchant if the customer refuses the package.

Managing Cash on Delivery

If you choose to offer Cash on Delivery, you should not offer it to everyone. You can set rules to hide this option for orders over a certain amount or for customers who have a history of high returns (identified via customer tags). This protects your business from high shipping and return costs; the help guide [How to create a payment customization](How to create a payment customization) shows cart-total-based rules.

Addressing Chargeback Risks

Some payment methods are more prone to chargebacks than others. If you are selling high-risk products or digital goods, you might want to hide certain gateways that have weak merchant protection. By using rule-based logic, you can ensure that high-risk orders are only processed through gateways with the strongest fraud prevention tools, such as iyzico's protected payment system.

Action Summary: What to Do Next

To successfully implement and optimize your Shopify payment strategy in Turkey, follow these steps:

• Audit your current conversion rate: Look at your checkout drop-off. Are customers leaving because they don't see their preferred bank's installment options?
• Choose the right partner: If you value brand trust and buyer protection, look at iyzico. If you want fast setup and low fees, prioritize PayTR.
• Configure your API correctly: Ensure your test and live keys are properly managed and that your redirection URLs are functional.
• Install HidePay: Use the app to sort your gateways, rename them for better clarity, and hide irrelevant options for international shoppers by installing [HidePay — try HidePay on Shopify](HidePay: Hide Payment Methods).
• Test on mobile: A large percentage of Turkish e-commerce happens on mobile devices. Ensure your redirected payment pages are fully responsive.

If you want a single solution that also handles shipping rules alongside payments, consider the Nextools bundle described in the blog post [Introducing Nextools’ HideSuite: the bundle for smart Shopify merchants](Introducing Nextools’ HideSuite: the bundle for smart Shopify merchants). For merchants building custom Shopify Functions or migrating legacy scripts, check out [SupaEasy on the Shopify App Store](SupaEasy: AI Functions creator - From script to function: generate & migrate functions codeless) for codeless function generation.

The Role of Shopify Functions

Modern checkout customization on Shopify is powered by Shopify Functions. Unlike the old Script Editor, which was limited to Shopify Plus merchants and often slowed down the checkout, Functions are native to the Shopify infrastructure.

HidePay is built on these native Shopify Functions. This means that when you set a rule to hide or sort a payment method, it happens instantly within Shopify's own backend. There is no flashing or delay for the customer. For a merchant in Turkey, where internet speeds can vary, having a fast, native checkout experience is critical for maintaining high performance and SEO rankings.

Learn more about how HidePay fits into Nextools’ app ecosystem on the [Nextools blog index](Blog - Nextools Tech).

Localization Beyond Language

Localization in the Turkish market is about more than just translating "Checkout" to "Ödeme." It is about matching the financial habits of the population. This includes:

1. Showing the TRY symbol clearly: Customers want to see the price in their local currency to avoid bank conversion surprises.
2. Highlighting security: Use icons and text to emphasize that your payment gateways are PCI-DSS compliant.
3. Localizing the labels: Use terms like "Kredi Kartı / Banka Kartı" instead of just "Credit Card."

By focusing on these small details, you build a store that feels local and trustworthy. When you combine the power of a global platform like Shopify with the local expertise of iyzico or PayTR, and then layer on the control provided by our tools, you create a world-class shopping experience.

Conclusion

Setting up your Shopify store in Turkey requires a shift in thinking compared to the US or UK markets. Without Shopify Payments, your choice of third-party gateway becomes the foundation of your checkout experience. iyzico and PayTR both offer excellent services, but they require careful configuration to perform at their best.

By focusing on the following, you can ensure your store is optimized for success:

• Integrate local gateways that support the Turkish installment system.
• Use rule-based logic to show the most relevant payment methods to each customer.
• Protect your business by hiding high-risk payment options based on cart value or customer location.

Optimizing your checkout is an ongoing process of testing and refining. We invite you to [install HidePay](HidePay: Hide Payment Methods) from the Shopify App Store to start building a more efficient and higher-converting checkout experience for your Turkish store.

FAQ

Can I use Shopify Payments if I live in Turkey?

No, Shopify Payments is currently not available for businesses registered in Turkey. You must use one of the supported third-party providers like iyzico, PayTR, or other local virtual POS solutions to accept credit card payments.

Is PayTR or iyzico better for a new Shopify store?

Both are excellent choices. PayTR is often preferred by new merchants who want a very fast approval process and lower initial fees. iyzico is often chosen by brands that want to leverage its high consumer brand recognition and built-in buyer protection features.

How do I offer installments (Taksit) on my Shopify store?

To offer installments, you must integrate a Turkish payment gateway like iyzico or PayTR. Once integrated, the gateway will automatically detect the customer's card type at checkout and display the available installment options provided by the Turkish banks.

How can I hide PayTR for my international customers?

Using HidePay, you can create a geography-based rule. See the help doc [How to create a payment customization](How to create a payment customization) for details on creating a rule to hide specific payment methods for customers outside of Turkey.

---

Links used in this article:

• HidePay: Hide Payment Methods (Shopify App Store)
• How to create a payment customization (HidePay help doc)
• Sort and Rename payment methods in the Checkout (HidePay help doc)
• Hide the Express Checkout with HidePay (HidePay help doc)
• Do I need Shopify Plus to modify the checkout? (HidePay help doc)
• Introducing Nextools’ HideSuite: the bundle for smart Shopify merchants (Nextools blog)
• Blog - Nextools Tech (Nextools blog index)
• SupaEasy: AI Functions creator (Shopify App Store)