iyzico Integration Setup (Turkey)
Learn how to connect your iyzico account to receive online payments from your clients via credit card.
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 iyzico's standard processing fee.
Your Money, Your Account
Payments go directly into YOUR iyzico 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 iyzico 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 iyzico?
iyzico is Turkey's leading online payment platform that allows you to accept credit/debit card payments from your clients. It supports all major Turkish banks and card networks, making it the ideal choice for receiving payments within Turkey.
When to Use iyzico?
Turkish Clients
Accept payments from clients in Turkey with Turkish Lira.
Local Cards
Support all Turkish bank cards and credit cards.
Installments
Offer installment options to your clients (bank dependent).
Prerequisites
Before setting up iyzico integration, you need:
iyzico Account
Create a merchant account at iyzico.com if you don't have one.
Verified Account
Complete iyzico's merchant verification process.
Bank Account
Add your bank account (IBAN) to iyzico for payouts.
Create Account
Go to iyzico.com and apply for a merchant account.
Step-by-Step Setup
Follow these steps to connect iyzico to Mindora:
Go to Settings
Click on the gear icon in the top right corner, or navigate to Settings from the sidebar menu.
Open Integrations
In the Settings menu, click on "Integrations" to see all available integrations.
Find iyzico Card
Look for the iyzico card in the "Payment & Finance" category. Click "Setup" button on the card.
Get API Keys from iyzico
Log in to iyzico Merchant Panel. Go to Settings β Company Settings to find your API keys.
Enter API Key
Copy your API Key and paste it in Mindora.
Enter Secret Key
Copy your Secret Key and paste it in Mindora.
Set Link Expiration
Choose how long payment links should be valid (default: 24 hours).
Test Connection
Click "Test Connection" to verify your API keys are working correctly.
Save
Click "Save" to complete the setup.
Finding API Keys in iyzico
Here's how to find your API keys in iyzico Merchant Panel:
Open iyzico Merchant Panel
Go to merchant.iyzico.com and log in to your account.
Navigate to Settings
Click on "Ayarlar" (Settings) in the menu.
Click Company Settings
Select "Firma AyarlarΔ±" (Company Settings) from the submenu.
Copy Keys
You'll see your API Key and Secret Key. Copy both of them.
Sandbox Mode vs Live Mode
iyzico provides two environments:
Live Mode
- Uses production API keys.
- Processes real payments from real cards.
- Money is actually transferred.
- Use this when you're ready to accept payments.
Sandbox Mode
- API Key starts with "sandbox-".
- No real money is transferred.
- Use test card numbers provided by iyzico.
- Good for testing the flow before going live.
Always use sandbox credentials 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 iyzico is connected:
The iyzico 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 iyzico'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 keys.
Change API Keys
Update to new keys if needed (e.g., switching from sandbox to live).
Disconnect
Remove the integration completely. Active payment links will stop working.
- If you have active payment links, the system will automatically expire them on iyzico before removing your credentials.
- A confirmation dialog will show you how many active links will be expired. You must confirm before proceeding.
- Your API keys 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 iyzico dashboard.