Setting Up iyzico

Setting Up iyzico

iyzico is a leading payment provider in Turkey, supporting credit cards, debit cards, and installment payments. It is the recommended payment option for stores targeting the Turkish market.

Step 1: Create an iyzico Merchant Account

1. Visit iyzico.com and click "Basvuru Yap" (Apply).
2. Fill in your business details: company name, tax number, contact information.
3. Upload the required documents (identity, business registration).
4. iyzico will review your application, typically within 1-3 business days.

Step 2: Get Your API Keys

1. Log in to the iyzico Merchant Panel.
2. Navigate to Settings > API Keys.
3. Copy your API Key and Secret Key.
4. iyzico provides separate keys for sandbox (test) and production environments.

Step 3: Configure iyzico in Nuvi

1. In Nuvi admin, go to Settings > Regions.
2. Select your Turkish region (or create one if it does not exist).
3. Under Payment Providers, select iyzico.
4. Enter your API Key and Secret Key.
5. Set the mode to Sandbox for testing or Live for production.
6. Save your settings.

Step 4: Test Payments

In sandbox mode, use iyzico's test card numbers:

• Visa: 5528790000000008
• Mastercard: 5400360000000003
• Use any future expiry date and CVC 123.

Step 5: Go Live

After successful testing:

1. Switch from sandbox to production API keys in Nuvi settings.
2. Change the mode from Sandbox to Live.
3. Save and verify with a small real transaction.

Installment Payments

iyzico supports installment payments (taksit), which are very popular in Turkey. Customers can split their payment into 2, 3, 6, 9, or 12 monthly installments depending on their bank card. This is configured in your iyzico merchant panel.