# Connect your iyzico account

> Take cards, installments, bank transfers and BKM Express in Turkey with your own iyzico account. In Settings > Payments, click Set up iyzico, paste your API key and secret key, switch it on and click Save settings.

Help Centre / Payments - Updated 19 November 2026

iyzico is one of the most used ways to pay online in Turkey. When you connect your iyzico account, your customers can pay by card, spread a card payment over installments when their card allows it, pay by bank transfer, or use BKM Express and their iyzico wallet. Payments go straight to your iyzico account, and Shoprocket takes 0%.

Your customers pay without leaving your shop. When they click **Pay now**, iyzico's payment form appears right inside your checkout. They pay there and then see their order confirmation. Card details go straight to iyzico and never pass through Shoprocket.

## Before you start

You need an iyzico merchant account. Your keys are in your iyzico merchant panel, under **Settings > Company Settings**. There are two kinds of keys:

- **sandbox keys**, from iyzico's test panel at sandbox-merchant.iyzipay.com, which start with `sandbox-`, for trying your checkout without real money
- **live keys**, from merchant.iyzipay.com, for taking real payments once iyzico has activated your business

Each kind comes as a pair: an **API key** and a **secret key**. You need both, from the same panel.

## Connect iyzico

1. In your dashboard, go to **Settings > Payments**.
2. On the iyzico card in **Payment gateways**, click **Set up iyzico**.
3. Paste your **API Key** and **Secret Key**.
4. If your iyzico account takes currencies other than Turkish lira, type them into **Currencies**, for example `TRY, USD, EUR`. Leave it blank if you take lira only.
5. Turn iyzico's switch to **On**.
6. Click **Save settings**.

![The iyzico card in Settings > Payments: Connected with a test key, the currency the account takes, and the webhook URL with its Copy button](https://shoprocket.io/img/help/connect-iyzico/iyzico-card.webp)

When you save, Shoprocket checks your keys with iyzico. If iyzico rejects them, nothing is saved and a message at the top of the screen says why. The card then says **Connected**, and iyzico appears at your checkout.

## The currencies your account takes

Every iyzico account takes Turkish lira. iyzico can also switch on US dollars, euros, pounds, Norwegian krone and Swiss francs for your account, if you ask them. iyzico doesn't tell Shoprocket which of these your account has, so you list them yourself under **Currencies**.

iyzico appears at checkout only for customers paying in a currency on your list. If you list one currency and your shop is priced in another, the card warns you, and you can still offer iyzico to customers paying in its currency under **Card gateway by currency**, as [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md) explains.

## Add your webhook URL in iyzico

Once iyzico is connected, its card shows a **Webhook URL**. iyzico uses it to tell Shoprocket about payments that finish later, such as a bank transfer a customer makes after leaving your shop.

1. Click the copy button next to the webhook URL.
2. In your iyzico merchant panel, go to **Settings > Merchant Settings > Merchant Notifications**.
3. Paste the URL and save.

Your orders are still confirmed without the webhook URL, because Shoprocket checks each payment with iyzico itself. Adding it means a late bank transfer shows on its order sooner.

iyzico can also sign each message it sends, so Shoprocket can tell it really came from iyzico. To switch this on, email entegrasyon@iyzico.com and ask for webhook signatures. Shoprocket checks the signature as soon as iyzico starts sending it. You don't need to change anything here.

## Try it with sandbox keys

Paste your sandbox keys to try your checkout without moving real money. The card then shows **Test key: no real money moves**. iyzico's developer documentation lists the test cards to use, and the code for any 3D Secure check in the sandbox is always `283126`.

When you are ready to sell, click **Edit iyzico credentials**, paste your live keys, and click **Save settings**.

## How customers pay

- **By card**: the customer types their card into iyzico's form. If their card allows installments, the form offers them, and the customer picks how many. If their bank needs a 3D Secure check, that happens in the same form.
- **By bank transfer**: iyzico's form shows the bank account to pay into, and iyzico also sends the details by text message and email. The order waits as **Processing**, with its items reserved, until the money arrives, then it is confirmed. Customers have 3 business days to make the transfer. iyzico switches bank transfer on for your account when you ask them.
- **With BKM Express or an iyzico wallet**: the customer signs in inside iyzico's form and pays.

If a customer changes their mind, they can click **Back to checkout** under iyzico's form. They are back in your checkout with everything they typed, and can try again.

You don't need to do anything for any of these. Shoprocket marks the order paid when iyzico confirms the payment, and sends your usual order emails.

## Refunds

When you refund an order paid with iyzico, the money goes back to the customer automatically, in full or in part. See [Refund an order](https://shoprocket.io/help/refund-an-order.md). A full refund on the day of the payment cancels the payment, so it never shows on the customer's card statement. After that day, it is a normal refund, which the customer's bank usually shows within a few days.

A refund you make in your iyzico merchant panel does not appear on the order in Shoprocket. Refund from Shoprocket so the order stays up to date.

## Subscriptions

iyzico can't renew subscriptions in Shoprocket yet. Saving a customer's card for renewals needs iyzico to switch on card storage for your account. A checkout with a subscription in it offers your other gateways instead.

## Changing your keys or turning it off

Once iyzico is connected, its button reads **Edit iyzico credentials**. Your saved keys are stored encrypted and never shown again. The card shows only the last four characters of your API key. To keep them, leave the fields blank. To replace them, paste both new keys and click **Save settings**.

To stop offering iyzico, turn its switch to **Off** and click **Save settings**. Your keys stay saved, so you can switch it back on at any time.

## Related

- [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md)
- [Refund an order](https://shoprocket.io/help/refund-an-order.md)
- [Take a test order](https://shoprocket.io/help/take-a-test-order.md)

[Open Payments in your dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/help/connect-iyzico
- Language: English (en)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-iyzico.md), [Deutsch](https://shoprocket.io/de/hilfe/iyzico-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-iyzico.md), [Español](https://shoprocket.io/es/ayuda/conectar-iyzico.md), [Français](https://shoprocket.io/fr/aide/connecter-iyzico.md), [עברית](https://shoprocket.io/he/help/connect-iyzico.md), [हिन्दी](https://shoprocket.io/hi/help/connect-iyzico.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-iyzico.md), [Italiano](https://shoprocket.io/it/aiuto/collega-iyzico.md), [日本語](https://shoprocket.io/ja/help/connect-iyzico.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-iyzico-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-iyzico-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/iyzico-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-iyzico.md), [Português](https://shoprocket.io/pt/ajuda/conectar-iyzico.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-iyzico.md), [Русский](https://shoprocket.io/ru/help/connect-iyzico.md), [ไทย](https://shoprocket.io/th/help/connect-iyzico.md), [Türkçe](https://shoprocket.io/tr/yardim/iyzico-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-iyzico.md)
