mindora
All GuidesIntegrations

PayTR Integration Setup (Turkey)

Learn how to connect your PayTR account to receive online payments from your clients via credit card.

6 min
Beginner

Why Mindora for Payments?

Before diving into the setup, here is why therapists and professionals choose Mindora for payment collection:

Zero Platform Commission

Unlike many booking platforms that take 0.5–1% (or more) from every single transaction, Mindora charges absolutely zero commission. Your client pays, and 100% goes to your account — minus only PayTR's standard processing fee.

Your Money, Your Account

Payments go directly into YOUR PayTR account. We never touch your money. Many competitors route payments through their own accounts first, creating delays and dependencies. With Mindora, there is no middleman.

Full Ownership

Your PayTR account, your client data, your payment history — it all belongs to you. If you ever leave Mindora, nothing changes on the payment side. No lock-in, no data loss.

What is PayTR?

PayTR is a Turkish payment platform that allows you to accept credit/debit card payments from your clients. It provides a simple and secure payment infrastructure for Turkish businesses, supporting all major Turkish banks and card networks.

PayTR

When to Use PayTR?

Turkish Clients

Accept payments from clients in Turkey with Turkish Lira.

Local Cards

Support all Turkish bank cards and credit cards.

Simple Integration

Easy setup with just three credentials

Prerequisites

Before setting up PayTR integration, you need:

1

PayTR Account

Create a merchant account at paytr.com if you don't have one.

2

Verified Account

Complete PayTR's merchant verification process.

3

Bank Account

Add your bank account (IBAN) to PayTR for payouts.

Tip
Don't have a PayTR account yet? Check our step-by-step account setup guide. → PayTR Account Setup (Turkey)

Step-by-Step Setup

Follow these steps to connect PayTR to Mindora:

Tip
Only one payment integration can be active at a time. If you already have another active integration (e.g., Stripe or iyzico), you'll see a confirmation dialog when starting PayTR setup. The existing integration will be deactivated when PayTR is connected.
1

Go to Settings

Click on the gear icon in the top right corner, or navigate to Settings from the sidebar menu.

2

Open Integrations

In the Settings menu, click on "Integrations" to see all available integrations.

3

Find PayTR Card

Look for the PayTR card in the "Payment & Finance" category. Click "Setup" button on the card.

4

Get Credentials from PayTR

Log in to PayTR Merchant Panel to find your credentials.

5

Enter Merchant ID

Copy your Merchant ID (Mağaza ID) - this is a numeric value.

6

Enter Merchant Key

Copy your Merchant Key (Mağaza Anahtarı) and paste it in Mindora.

7

Enter Merchant Salt

Copy your Merchant Salt (Mağaza Gizli Anahtar) and paste it in Mindora.

8

Set Link Expiration

Choose how long payment links should be valid (default: 24 hours).

9

Test Connection

Click "Test Connection" to verify your credentials are working correctly.

10

Save

Click "Save" to complete the setup.

Finding Credentials in PayTR

Here's how to find your credentials in PayTR Merchant Panel:

1

Open PayTR Merchant Panel

Go to paytr.com and log in to your merchant account.

2

Navigate to Settings

Click on "Ayarlar" (Settings) in the menu.

3

Find API Information

Look for "API Bilgileri" or "Mağaza Bilgileri" section.

4

Copy Credentials

You'll see Mağaza ID, Mağaza Anahtarı, and Mağaza Gizli Anahtar. Copy all three.

Tip
Keep your Merchant Key and Merchant Salt confidential. Never share them publicly or commit them to version control.
Important
The Merchant ID must contain only numbers. If you see any validation error, make sure you copied the correct numeric ID.
Critical Warning for Testing

Always test with fake/test sessions only. Never test payment flows on real client sessions.

When a session is paid via a real or fake payment link, the system locks it permanently:

  • Payment status cannot be changed.
  • New payment link cannot be created.
  • Session fee cannot be modified.

Create a test client and test sessions specifically for testing payment flows.

After Setup

Once PayTR is connected:

The PayTR card on the Integrations page shows "Active" status with a green indicator.

You can create payment links from the Payments module. → Creating Payment Links

Clients can pay via PayTR's secure payment page.

Payment statuses update automatically. → Understanding Payment Statuses

All activities are recorded in payment history. → Payment History

Managing Your Integration

You can update or disconnect your integration at any time:

Update Settings

Change link expiration time without re-entering credentials.

Change Credentials

Update to new credentials if needed.

Disconnect

Remove the integration completely. Active payment links will stop working.

What happens when you disconnect?
  • If you have active payment links, the system will automatically expire them on PayTR before removing your credentials.
  • A confirmation dialog will show you how many active links will be expired. You must confirm before proceeding.
  • Your credentials are stored encrypted with AES-256-GCM (256-bit) and are permanently deleted when you disconnect; Mindora does not retain them after disconnection.
  • Previously completed payments and refund records are preserved in payment history.
  • Refunds for past payments can no longer be processed through Mindora — you will need to refund manually from your PayTR dashboard.

Common Issues

Invalid Merchant ID
Make sure the Merchant ID contains only numbers. Do not include any letters or special characters.
Connection Test Fails
Verify your PayTR account is active and not restricted. Check if you copied all three credentials correctly.
Payment Links Not Working
Ensure your PayTR account has been fully verified and approved for live transactions.
PayTR Fees
PayTR charges transaction fees for each payment. The fees vary based on your merchant agreement. Check your PayTR merchant panel for your specific rates. These fees are standard for payment processing and are separate from Mindora's subscription.