Short answer
A Shopify PayTR integration means installing PayTR Sanal POS, PayTR’s official app on the Shopify App Store, and connecting it to your PayTR merchant panel account. Because Shopify Payments is not offered to companies based in Turkey (Shopify Payments supported countries), Turkish stores take card payments through alternative payment providers; PayTR is one of these providers, activated in Shopify under Settings > Payments. The app is developed by PayTR Ödeme ve Elektronik Para Kuruluşu A.Ş., a payment and e-money institution licensed by the Central Bank of the Republic of Turkey.
With an approved PayTR account, the technical setup is done within a few hours. The real timeline depends on application approval, Shopify checkout settings, test orders and setting up refunds and reconciliation. Once the account is approved, taking live payments safely within 3–5 business days is a realistic frame.
This guide was prepared with the field experience of the Byte Digital team, a Shopify Plus Partner that has served Shopify brands since 2020.
How does PayTR work on Shopify?
PayTR connects to Shopify as an approved payments app: the customer chooses PayTR on the Shopify checkout, enters card details in PayTR’s payment step, and the payment result is written back to the Shopify order. PayTR’s Shopify payment infrastructure runs on its iFrame API, the integration was announced in 2022, and the app is listed as free on the App Store; the transaction commission is set by your agreement with PayTR.
Its market share is not small either: in Byte’s technical analysis of 100 Shopify stores in Turkey, 30 of the stores took payments with PayTR. That makes PayTR the second most common payment provider among Turkish Shopify stores, after iyzico.
Stage | Where it happens | What happens |
|---|---|---|
Choosing the payment method | Shopify checkout | The customer chooses to pay with PayTR |
Card, installments and bank verification | PayTR payment step | Card data is processed by PayTR; installment options are shown according to your account settings |
Order creation | Shopify | The payment confirmation returns to Shopify; the PayTR transaction number is written to the order details |
Refund | Shopify admin | The refund is started with the “Refund” button on the order |
Payout | PayTR | Funds are transferred to your account according to the settlement term in your PayTR agreement |
Card data is not stored in Shopify or in your theme. On its App Store page, PayTR states that it uses PCI-DSS Level 1 Service Provider-level infrastructure and protects against fraud.
PayTR-specific points: checkout, installments, refunds
The point that needs the most attention in a PayTR integration is that Shopify passes limited data to PayTR, so Shopify checkout settings and your reconciliation routine should be settled before setup. The warnings in PayTR’s official setup guide make this clear (PayTR Shopify documentation).
Checkout settings: PayTR asks for the customer contact method in Shopify to be set to email only and for first and last name fields to be required. Without these settings, payments may fail. If you customize the checkout with apps, check that fields on the Shopify Checkout Extensibility side do not conflict with this rule.
Limited order data: According to PayTR’s guide, the PayTR panel shows a fixed product description and a placeholder phone number for transactions. Track the actual products and customer details in the Shopify order.
Installments: PayTR announced that it lets customers pay in a single payment or in installments through Shopify. Which cards get how many installments, and who carries the installment surcharge, depends on your PayTR account settings and agreement; the Shopify checkout has no installment table specific to Turkish banks.
3D Secure: PayTR’s Shopify guide does not cover 3D settings. Which transactions go through 3D verification depends on PayTR’s and the banks’ rules; confirm this policy with PayTR during your application.
Refunds: PayTR recommends refunding with the “Refund” button on the order details page in Shopify. According to the guide, refunds made from the PayTR merchant panel are currently not reflected on the Shopify order.
Payouts: On its App Store page, PayTR highlights receiving payments on the “next business day” as an advantage. The term that applies to you depends on your agreement.
PayTR, iyzico or Craftgate?
PayTR and iyzico are payment institutions with a similar position for stores that want to start fast with a single contract; Craftgate is an orchestration layer for high-volume brands that want to use their own bank POS agreements. In Byte’s analysis, 94 of the 100 stores used one of these three providers.
Topic | PayTR | iyzico | Craftgate |
|---|---|---|---|
Model | Payment institution | Payment institution | Payment orchestration; does not provide a POS |
Who collects the funds | PayTR | iyzico | The banks and payment institutions you contract with |
Shopify app | PayTR Sanal POS | Official iyzico app | Craftgate Payment Gateway |
Contract | Single contract | Single contract | Separate with each bank + Craftgate |
Connection | Via PayTR merchant panel login | Via API keys | Via the Craftgate panel and bank POS definitions |
Usage among 100 stores | 30 | 45 | 19 |
When to choose | Fast start, if PayTR’s commercial terms suit you | Fast start, widely used payment experience | High volume, multiple banks |
We covered iyzico in our Shopify iyzico integration post and routing between banks in our Shopify Craftgate integration post. For the general choice between a payment institution and a bank POS, see our Shopify virtual POS setup guide. The choice between two payment institutions is usually commercial rather than technical: commission, settlement term, installment setup and support quality should be compared on the same scenario.
Shopify PayTR integration step by step
With an approved PayTR account, setup is completed in a few steps from the Shopify admin following the flow in PayTR’s official guide; allowing 3–5 business days including tests and reconciliation is enough.
Merchant application and approval (a few days): Company documents, legal pages and a ready-to-sell site are reviewed by PayTR. After approval, your PayTR merchant panel login details are sent to you.
Installing the app (15 minutes): Sign in to Shopify via the setup link in PayTR’s guide, select your store, and complete the “Connect” and then “Install app” steps.
Logging in to PayTR (10 minutes): Log in on the PayTR merchant panel screen you are redirected to. This screen times out after 3 minutes; if it expires, restart from the PayTR Sanal POS details under Settings > Payments using “Manage”. Then activate the app.
Checkout settings (15 minutes): In Shopify, set the customer contact method to email only and make first and last name required.
Checking the notification URL (10 minutes): In the Settings section of the PayTR merchant panel, confirm that the Callback URL matches the address given in PayTR’s documentation.
Test mode and test orders (1–2 days): Turn on test mode and run a trial; test orders appear in Shopify with a “Test True” note. Then test single payment, installments, failed verification, partial and full refunds and the mobile payment flow with small real orders.
Going live and reconciliation (first week): Turn off test mode. For the first week, match transactions in the PayTR panel daily with the PayTR transaction number shown in the payment gateway information on the Shopify order.
The main cost factors are: the commission and settlement term agreed with PayTR (varies by agreement), your installment and surcharge setup, the transaction fee Shopify charges with providers other than Shopify Payments (varies by plan), and whether payment data needs to flow to your ERP or e-invoice system.
The 6 most common Shopify PayTR integration mistakes
Most PayTR integration mistakes surface not during setup but with the first failed payments, the first refunds and the first month-end reconciliation.
Skipping the checkout settings: If customer contact is left open to phone or first and last name are not required, PayTR does not receive enough data and payments may fail.
Refunding from the PayTR panel: According to PayTR, these refunds are not reflected on the Shopify order; the order looks unrefunded and inventory and reports drift apart.
Leaving test mode on: When going live, check that test mode is off and that the first real order does not carry the “Test True” note.
Reconciling by product info in the PayTR panel: Because the panel shows a fixed product description, matching should be done by the PayTR transaction number on the Shopify order.
Not testing the mobile flow: PayTR’s payment step should be tested separately in mobile browsers and with transactions approved in a banking app; friction in the payment step directly affects your conversion rate.
Adding a second card provider without a reason: Two similar card options on the checkout leave customers undecided. A second provider should be added for a specific need and with a clear name.
Shopify PayTR integration with Byte Digital
Byte Digital is an Istanbul-based Shopify Plus Partner that has provided Shopify setup, migration and integration services to leading brands in Turkey since 2020. We handle PayTR setup not just as an app connection but end to end, together with checkout settings, installment setup, refund flow, reconciliation and ERP transfer.
Share your current payment setup, monthly order volume and the ERP you use; we will prepare a free pre-assessment covering whether PayTR is the right choice for you and a setup plan.
Request a free PayTR Shopify pre-assessment →
Frequently asked questions
Does PayTR work with Shopify?
Yes. PayTR has an official app on the Shopify App Store called PayTR Sanal POS. After installation, the app is connected to your PayTR merchant panel account and activated as a payment method under Settings > Payments.
Can I sell in installments with PayTR on Shopify?
Yes. PayTR states that it offers single and installment payments through Shopify. The installment options and surcharges offered depend on your PayTR account settings and agreement.
How do I refund a PayTR payment on Shopify?
Start the refund with the “Refund” button on the order details page in Shopify. According to PayTR, refunds made from the PayTR merchant panel are currently not reflected on the Shopify order.
Is the PayTR app paid?
The app is listed as free on the App Store. The transaction commission is set by your agreement with PayTR; Shopify also charges a plan-dependent transaction fee with providers other than Shopify Payments.
When are PayTR payments paid out?
On its App Store page, PayTR highlights receiving payments on the next business day. The settlement term that applies to you depends on your agreement with PayTR.
Can PayTR and iyzico be used together in the same store?
Yes. Multiple payment providers can be activated in Shopify. However, because two similar card options on the checkout can leave customers undecided, we recommend adding the second provider for a specific need and with a clear name.
