# iyzico Module

https://docs.wisecp.com/fr/iyzico-module

Collect credit and debit card payments through iyzico, so clients pay on your own order page and card details never reach your site.

## Reaching the Screen

Go to **Settings → Financial → Payment Gateways**, open **All Modules** and click the iyzico card: `{admin}/modules/payment?module=IyzicoV2`

Two iyzico modules ship with the system. **Iyzico V2** is the current one and this article describes it. **Iyzico** is the earlier module: it takes the same two keys, but it has no test mode and no installment setting.

Ticking **Status** and saving lists the method on the payment step. Use [Payment Gateways](https://docs.wisecp.com/en/payment-modules) to order the methods clients see.

## What Is on the Screen

The card holds your iyzico keys and the shared gateway settings every module has. The iyzico payment form opens inside your own order page, and the client types the card there.

This gateway takes one-off payments. Subscriptions, stored cards and refunds sent from the panel are not supported.

## Before You Configure It

- An iyzico merchant account. Test mode also needs a separate sandbox account, registered on iyzico's own sandbox merchant site.
- Both keys, taken from **Settings → Merchant Settings** in your iyzico panel. A Turkish panel names it **Ayarlar → Firma Ayarları**.
- A currency your iyzico account accepts. If your install prices in another one, set **Converting Currency**.

## Fields

- **Status**: Turns the module on. While it is off the other fields stay locked and clients are never offered the method.
- **API Anahtarı**: Required. The API key of your iyzico account. It arrives filled with a sample sandbox key, so replace it with your own. A sandbox key starts with `sandbox-`.
- **Güvenlik Anahtarı**: Required. The secret key that signs every request. It also arrives filled with a sample sandbox value and is kept hidden after saving.
- **Taksit Seçeneği Göster**: Optional. The installment counts offered on the iyzico form, separated by commas, such as `2,3,6,9`. It arrives as `2,3`; empty leaves the choice to iyzico.
- **Test Modu**: Sends every request to the iyzico sandbox instead of the live service. It arrives ticked, so untick it before you take real money.

The older **Iyzico** card carries only **API Key** and **Secret Key**, and it always talks to the live service.

Commission, converting currency, accepted amount range and country lists behave the same on every gateway; see [Payment Gateways](https://docs.wisecp.com/en/payment-modules). **Callback URL**, **Success URL** and **Failed URL** cannot be edited. iyzico is handed the callback address with each payment request, so you register nothing in your iyzico panel.

## Tasks

### Connect your iyzico account

1. Sign in to your sandbox account and open **Settings → Merchant Settings**. The **API Keys** section at the foot of that page reveals both keys with **Show detail**. Sandbox accounts live on `sandbox-merchant.iyzipay.com`.
2. Open the iyzico card under **All Modules** and tick **Status**.
3. Replace the sample values in **API Anahtarı** and **Güvenlik Anahtarı** with your own keys, and leave **Test Modu** ticked.
4. Click **Save Changes**. The method now appears on the payment step.

### Run a test payment

1. Place a small order as a client and choose iyzico on the payment step.
2. Pay with an iyzico sandbox test card on the form that opens.
3. The client returns to your site. Confirm the payment in your iyzico panel: this version can lose the return and leave the invoice open.

### Switch to live keys

1. Untick **Test Modu**.
2. Replace both keys with the live pair. Read them the same way, but from your live merchant panel: sandbox keys never work on the live service.
3. Click **Save Changes**, then pay one low-value invoice for real and confirm the money reaches your iyzico account.

### Offer installments

1. Write the counts you have agreed with iyzico into **Taksit Seçeneği Göster**, such as `3,6,9`.
2. Click **Save Changes**.
3. The iyzico form now shows those counts to a client whose card supports them.
4. An installment plan that costs more adds the difference to the invoice as a separate line. The order total follows it.
5. A filled **Converting Currency** field switches that off, so the difference stays off the invoice.

## Things to Watch

> **Test mode collects nothing**
> 
> A payment made while **Test Modu** is ticked marks the invoice as paid and activates the order, but no money moves. Untick it the moment you enter live keys. The key fields also arrive filled with sample sandbox keys that are not yours. Replace both before you take real money.

> **A refund is not sent to iyzico**
> 
> On the invoice, **Refund via payment gateway** is switched off for this module. The panel shows **Current payment gateway does not support automatic refunds.** Record it with **Add as expense** or **Add as account credit**, then return the money from your iyzico panel yourself.

> **The two iyzico modules look alike**
> 
> The payment step lists V2 as **Pay by iyzico** and the older module as **Credit Card**. Two iyzico rows then sit side by side, so enable one of them. **Credit Card (iyzico)** is the name written on the invoice record and in notifications.

> **Confirm that the return settled the invoice**
> 
> iyzico sends the client back with a cross-site request. This version looks for the payment token in the browser session, which that request does not carry. The invoice can stay open while the money is already taken. Compare your iyzico transactions with your open invoices before you rely on the method.

## Required Privileges

**Payment Module Settings** (`MODULES_PAYMENT_SETTINGS`) is required.

## Related Articles

- [Payment Gateways](https://docs.wisecp.com/en/payment-modules)
- [Invoice Detail](https://docs.wisecp.com/en/invoice-detail-overview)
- [Module Management](https://docs.wisecp.com/en/module-management)