Payments
PayTR Integration: 3D Secure Card Payments and Refunds
How do you take payments with PayTR on Esoltec? Esoltec's PayTR integration lets you take card payments with your own PayTR account, set up in one of two ways: “PayTR”, where the card is entered on PayTR's secure payment page, or “PayTR Direkt API”, where it is taken at your own checkout. You enter the Merchant ID, Merchant Key and Merchant Salt in Finance › Payment Settings and add the notification URL to your PayTR panel. Payments are single payments; you refund from the order detail.
Integration details
- Support status
- Available: connect it from the admin panel with your own account
- Last updated
- Owner
- Esoltec product team
- In the panel
- Finance › Payment Settings
- Step-by-step guide
- Step-by-step guide (in Turkish)
What you can do
PayTR payment page: with the “PayTR” option, the customer enters card details on PayTR's secure payment page; PayTR handles verification.
Direct API: with the “PayTR Direkt API” option, card details are taken at your own checkout and the payment completes with 3D Secure verification.
Payment result: PayTR sends the result to the notification URL, and the order is marked as paid with that notification.
Refunds: you refund all or part of the amount through PayTR from the “Payment Info” tab of the order detail.
Test and live modes: test and live keys are stored separately.
How to connect it
- 01
In Finance › Payment Settings, press “Add Provider” and choose the “PayTR” card (PayTR payment page) or the “PayTR Direkt API” card.
- 02
Enter the Merchant ID, Merchant Key and Merchant Salt; verify them with “Test” and press “Connect”.
- 03
Add the notification URL shown in the provider's “Settings” window to your PayTR store panel as the notification URL.
- 04
Switch the provider to “Live” and make it “Active”.
What you need
- A PayTR store account with its Merchant ID, Merchant Key and Merchant Salt.
- For the “PayTR Direkt API” option, permission from PayTR to use the Direct API.
- The notification URL defined in your PayTR panel.
Limits to know
Things that don't work today or work differently; when they change, this page and its date are updated.
- No installments: with both options, payments are taken as a single payment; even though the panel shows an installment field, customers are not offered installments.
- If the notification URL is not defined, the payment result does not reach the panel; a card order with no result is cancelled automatically after 30 minutes.
- There are no saved cards; customers enter their card details for every payment.
Frequently asked questions
Can I sell in installments with PayTR?
Not today. Esoltec's PayTR integration takes single payments with both options; for installment sales you can connect iyzico or MoneyPay.
Why is the PayTR notification URL required?
PayTR sends the payment result to this URL, and the order is marked as paid only when the notification arrives. If the URL is not defined, an order with no result is cancelled after 30 minutes.
Can I make partial refunds with PayTR?
Yes. On the “Payment Info” tab of the order detail, use “Refund” to return part of the amount; a refund reason is required and total refunds cannot exceed the order amount.
What is the difference between “PayTR” and “PayTR Direkt API”?
With the “PayTR” option, the customer enters card details on PayTR's secure payment page. With “PayTR Direkt API”, card details are taken at your own checkout; this option requires permission from PayTR to use the Direct API.
Get started today
Take your first step toward the future of e‑commerce.
Ready-made templates for your industry, campaign and coupon tools, abandoned cart emails, and payment and shipping integrations are waiting for you in every plan.