Title: Serkany Direct Checkout for iyzico – Kartla Ödeme ve Taksit
Author: serkan52
Published: <strong>November 20, 2026</strong>
Last modified: November 21, 2026

---

Search plugins

![](https://ps.w.org/serkany-direct-checkout-for-iyzico/assets/banner-772x250.png?
rev=3815005)

![](https://ps.w.org/serkany-direct-checkout-for-iyzico/assets/icon-256x256.png?
rev=3814523)

# Serkany Direct Checkout for iyzico – Kartla Ödeme ve Taksit

 By [serkan52](https://profiles.wordpress.org/serkan52/)

[Download](https://downloads.wordpress.org/plugin/serkany-direct-checkout-for-iyzico.1.3.6.zip)

 * [Details](https://wordpress.org/plugins/serkany-direct-checkout-for-iyzico/#description)
 * [Reviews](https://wordpress.org/plugins/serkany-direct-checkout-for-iyzico/#reviews)
 *  [Installation](https://wordpress.org/plugins/serkany-direct-checkout-for-iyzico/#installation)
 * [Development](https://wordpress.org/plugins/serkany-direct-checkout-for-iyzico/#developers)

 [Support](https://wordpress.org/support/plugin/serkany-direct-checkout-for-iyzico/)

## Description

**Serkany Direct Checkout for iyzico** collects card details on your own WooCommerce
checkout page and charges them through the iyzico Direct API. The customer is never
sent to an iyzico hosted page or pop-up; only the bank’s 3D Secure verification 
screen opens, and the customer returns to your store when the payment is done.

The plugin is built for stores in Turkey and its interface is in Turkish. A full
Turkish description (Türkçe açıklama) follows below.

#### Why this plugin?

 * **The customer stays on your site.** The card form is part of your checkout page;
   no iyzico Checkout Form or redirect is used.
 * **Installments for the card being used.** When the first 8 digits are entered,
   the card’s bank, card program (Bonus, World, Maximum, Axess…) and the installment
   options from your iyzico account are listed with the monthly amount and total.
 * **No lost payments.** If the customer cannot return to your store after 3D Secure,
   the result arrives through the signed iyzico notification (webhook) and the order
   is updated.
 * **No double charges.** Before a new attempt starts, the result of the previous
   attempt is queried from iyzico; concurrent returns are processed one at a time.
 * **Same-day refunds stay off the statement.** A full refund first tries a cancellation;
   otherwise it refunds per item. Partial refunds are supported.
 * **Customers understand declines.** Clear Turkish messages such as “insufficient
   limit” or “card closed to online shopping”; lost/stolen card codes show no details.
 * **Encrypted API keys.** Keys are stored encrypted in the database; a database
   backup alone does not reveal them.
 * **Nothing is locked.** No license key, trial period or per-transaction fee.

#### Features

 * 3D Secure payments: the iyzico signature, `mdStatus`, amount, currency and basket
   ID are verified on return.
 * Installments on the classic and block checkout and on the “pay for order” page.
   Amounts are recalculated on the server at payment time; the installment fee is
   added to the order as a separate fee line.
 * Cancellation and refunds (full or partial) with the WooCommerce “Refund” button.
 * Optional webhook verified with the `X-IYZ-SIGNATURE-V3` signature; the result
   is always confirmed by querying iyzico.
 * WooCommerce Checkout block and classic checkout; HPOS compatible.
 * Currencies: TRY, USD, EUR, GBP, NOK, CHF. Installments only in TRY.

Because card data passes through your server, your store falls under PCI DSS (SAQ
D) scope.

#### Pro version (coming soon)

A separate add-on, **Serkany Direct Checkout for iyzico Pro**, will add an installment
table on product pages, BDDK installment limits by product group (with one-screen
category mapping), and installment rules per product, per category and by minimum
cart total. No feature of this plugin depends on Pro or is restricted.

This plugin is not developed by, affiliated with or endorsed by iyzico. iyzico is
a registered trademark of iyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.

### Türkçe

**Serkany Direct Checkout for iyzico**, kart bilgilerini doğrudan WooCommerce ödeme
sayfanızda alır ve iyzico Direct API ile tahsil eder. Müşteri iyzico’nun ödeme sayfasına
ya da açılır pencereye yönlendirilmez; yalnızca bankasının 3D Secure doğrulama ekranı
açılır ve ödeme bitince mağazanıza döner.

**Neden bu eklenti?**

 * **Müşteri sitenizden ayrılmaz.** Kart formu ödeme sayfanızın bir parçasıdır; 
   iyzico Checkout Form ya da yönlendirme kullanılmaz.
 * **Taksit seçenekleri kartın kendisine göre.** Kart numarasının ilk 8 hanesi girilince
   o kartın bankası, kart ailesi (Bonus, World, Maximum, Axess…) ve iyzico hesabınızdaki
   taksit seçenekleri aylık tutar ve toplamla listelenir.
 * **Ödeme kaybolmaz.** Müşteri 3D Secure’dan sonra mağazaya dönemese bile ödeme
   sonucu imzalı iyzico bildirimiyle (webhook) alınır ve sipariş güncellenir.
 * **Çift çekim olmaz.** Yeni deneme başlamadan önce önceki denemenin sonucu iyzico’dan
   sorgulanır; aynı anda gelen dönüşler sıraya alınır.
 * **Aynı gün iade ekstrede görünmez.** Tam iadede önce iptal denenir; olmazsa ürün
   bazında iade yapılır. Kısmi iade desteklenir.
 * **Müşteri neden reddedildiğini anlar.** “Kartınızın limiti yetersiz”, “Kartınız
   internetten alışverişe kapalı” gibi Türkçe mesajlar; kayıp/çalıntı kart gibi 
   durumlarda ayrıntı verilmez.
 * **API anahtarlarınız şifreli.** Anahtarlar veritabanında şifreli saklanır; veritabanı
   yedeği tek başına anahtarları ele geçirmeye yetmez.
 * **Hiçbir özellik kilitli değil.** Lisans anahtarı, deneme süresi ya da işlem 
   başına ücret yok.

**Kurulum:** WooCommerce  Ayarlar  Ödemeler  Kart ile Ödeme (Serkany Direct Checkout
for iyzico) sayfasında iyzico API Anahtarı ve Güvenlik Anahtarı’nı girin, taksit
için “Taksit desteği”ni açın. Önce test modunda bir sipariş verin.

**Pro sürüm (yakında):** Ürün sayfasında taksit tablosu, BDDK taksit sınırları ve
ürün/kategori bazlı taksit kuralları. Bu eklentinin hiçbir özelliği kısıtlanmaz.

### External services

Bu eklenti kart ödemelerini işlemek için iyzico ödeme API’sine bağlanır; eklentinin
çalışması için gereklidir. / This plugin connects to the iyzico payment API to process
card payments. It is required for the plugin to work.

 * **What is sent and when:** When a customer places an order with this payment 
   method, the card details (number, expiry date, CVC, cardholder name), the buyer’s
   name, e-mail, phone, Turkish ID number (the default value from the settings),
   billing and shipping address, IP address, and the order items and amounts are
   sent to iyzico to start the payment. When the first 8 digits of a card are entered
   on the checkout page, those 8 digits and the cart total are sent to list installment
   options. Refunds, cancellations and payment status queries send the related payment
   ID and amount.
 * **Ne zaman ne gönderilir:** Müşteri bu ödeme yöntemiyle sipariş verdiğinde kart
   bilgileri (numara, son kullanma tarihi, CVC, kart sahibinin adı), alıcının adı,
   e-postası, telefonu, T.C. kimlik numarası (ayarlardaki varsayılan değer), fatura
   ve teslimat adresi, IP adresi, sipariş kalemleri ve tutarlar ödemeyi başlatmak
   için iyzico’ya gönderilir. Ödeme sayfasında kartın ilk 8 hanesi girilince bu 
   8 hane ve sepet tutarı taksit seçeneklerini listelemek için gönderilir. İade,
   iptal ve ödeme durumu sorgularında ilgili ödeme numarası ve tutar gönderilir.
 * **Endpoints / Adresler:** https://api.iyzipay.com (live / canlı) and https://
   sandbox-api.iyzipay.com (test mode / test modu).
 * **Service provider / Hizmet sağlayıcı:** iyzi Ödeme ve Elektronik Para Hizmetleri
   A.Ş. — https://www.iyzico.com
 * Terms of use / Kullanım koşulları: https://www.iyzico.com/en/general-conditions
 * Privacy policy / Gizlilik politikası: https://www.iyzico.com/en/privacy-policy

The plugin does not contact any other external service. / Eklenti başka hiçbir dış
hizmete bağlanmaz.

**İletişim / Contact:** Serkan Yıldırım — https://portfolio.serkany.online

## Screenshots

[⌊Checkout page: the card form and the installment options for the card's bank (
WooCommerce Checkout block). / Ödeme sayfası: kart formu ve taksit seçenekleri.⌉⌊
Checkout page: the card form and the installment options for the card's bank (WooCommerce
Checkout block). / Ödeme sayfası: kart formu ve taksit seçenekleri.⌉[

Checkout page: the card form and the installment options for the card’s bank (WooCommerce
Checkout block). / Ödeme sayfası: kart formu ve taksit seçenekleri.

[⌊A clear Turkish message shown to the customer when a payment is declined. / Reddedilen
ödemede anlaşılır Türkçe mesaj.⌉⌊A clear Turkish message shown to the customer when
a payment is declined. / Reddedilen ödemede anlaşılır Türkçe mesaj.⌉[

A clear Turkish message shown to the customer when a payment is declined. / Reddedilen
ödemede anlaşılır Türkçe mesaj.

[⌊Settings: API keys, test mode, installments and webhook. / Ayarlar.⌉⌊Settings:
API keys, test mode, installments and webhook. / Ayarlar.⌉[

Settings: API keys, test mode, installments and webhook. / Ayarlar.

[⌊Order notes: 3D Secure payment and same-day cancellation as a refund. / Sipariş
notları.⌉⌊Order notes: 3D Secure payment and same-day cancellation as a refund. /
Sipariş notları.⌉[

Order notes: 3D Secure payment and same-day cancellation as a refund. / Sipariş 
notları.

[⌊Pro version (coming soon): installment table by card program on the product page./
Pro (yakında): ürün sayfasında taksit tablosu.⌉⌊Pro version (coming soon): installment
table by card program on the product page. / Pro (yakında): ürün sayfasında taksit
tablosu.⌉[

Pro version (coming soon): installment table by card program on the product page./
Pro (yakında): ürün sayfasında taksit tablosu.

## Installation

 1. Install the plugin from Plugins  Add New and activate it. WooCommerce must be active.
 2. Go to WooCommerce  Settings  Payments  **Kart ile Ödeme (Serkany Direct Checkout
    for iyzico)** and enter:
 3.  * **API Key** and **Secret Key** from the iyzico merchant panel (Settings > Merchant
       Settings > API Keys).
     * **Test mode:** sandbox keys start with “sandbox-“. Free sandbox account: https://
       sandbox-merchant.iyzipay.com/auth/register
     * **Default Turkish ID number:** iyzico requires this field. WooCommerce does 
       not collect it, so this value is sent with every order.
 4. For installments, enable “Installment support” and choose the maximum number of
    installments.
 5. (Optional) Webhook: enter the address shown on the settings page (`https://yourdomain/
    wc-api/iyzd_webhook/`) in the iyzico panel under Settings > Merchant Settings >
    Merchant Notifications and turn notifications on. The address must use HTTPS. Unsigned
    notifications are rejected by default, so ask integration@iyzico.com (entegrasyon@
    iyzico.com) to enable the signature header on your account. The sandbox does not
    send this header; to try webhooks in sandbox, temporarily untick “Reject unsigned
    webhook notifications”.
 6. Place a test order in test mode; if everything works, turn test mode off and enter
    your live keys.

## FAQ

### Is the customer sent to an iyzico page?

No. Card details are entered in the form on your checkout page. Only the bank’s 
3D Secure verification screen (SMS code) opens, then the customer returns to your
store.

### How do installments work?

Enable “Installment support” in the settings and choose the maximum number of installments.
Rates and who pays the installment fee come from the “Installment and Commission
Settings” in your iyzico panel. Installments are only available in TRY; debit cards
and cards without an installment program only see single payment.

### Which test cards can I use?

In sandbox mode, use 5890040000000016, 5526080000000006 or 4603450000000000 for 
a successful 3D Secure payment. Any future expiry date and any 3-digit CVC work.
SMS code: 283126.

### How are the API keys stored?

They are encrypted with libsodium before they are saved. The encryption key comes
from the `IYZD_ENCRYPTION_KEY` constant if you define it in `wp-config.php`, otherwise
from your site’s WordPress security keys (`LOGGED_IN_KEY` and `LOGGED_IN_SALT`).
If those security keys are changed (some security plugins rotate them), the saved
API keys can no longer be read: card payments are disabled, a notice is shown, and
you need to enter the keys again. Defining `IYZD_ENCRYPTION_KEY` (any long random
string) avoids this.

### Can I show card program logos?

The plugin does not include bank or card program logos, because they are registered
trademarks. The installment list shows the bank and card program name as text. If
you have the right to use a logo, return its full URL from the `iyzd_card_logo_file`
filter.

### Hooks for developers

 * `iyzd_max_installment` (filter): `( int $max, WC_Order|null $order, IYZD_Gateway
   $gateway )`. Narrows the maximum installment count for the cart or order. The
   result is kept between 1 and the setting.
 * `iyzd_installment_note` (filter): `( string $note, int $max, WC_Order|null $order,
   IYZD_Gateway $gateway )`. A short plain-text note shown under the installment
   list.
 * `iyzd_admin_options_after` (action): `( IYZD_Gateway $gateway )`. Adds a section
   below the settings fields, inside the WooCommerce settings form.
 * `iyzd_loaded` (action): Runs when the plugin classes are loaded. Use `iyzd_get_gateway()`
   to get the gateway instance.
 * `iyzd_installment_rate_limit` (filter): Installment queries per IP per minute(
   default 20).
 * `iyzd_customer_message` (filter): `( string $message, string $code )`. Changes
   the payment error message shown to the customer. `$code` is the iyzico error 
   code or one of `verify`, `stale`, `session`, `uncertain`, `md`, `md0`…`md9` (
   3D Secure mdStatus).
 * `iyzd_card_logo_file` (filter): `( string $file, string $family, string $bank)`.
   Logo URL for a card program; empty by default.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Serkany Direct Checkout for iyzico – Kartla Ödeme ve Taksit” is open source software.
The following people have contributed to this plugin.

Contributors

 *   [ serkan52 ](https://profiles.wordpress.org/serkan52/)

[Translate “Serkany Direct Checkout for iyzico – Kartla Ödeme ve Taksit” into your language.](https://translate.wordpress.org/projects/wp-plugins/serkany-direct-checkout-for-iyzico)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/serkany-direct-checkout-for-iyzico/),
check out the [SVN repository](https://plugins.svn.wordpress.org/serkany-direct-checkout-for-iyzico/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/serkany-direct-checkout-for-iyzico/)
by [RSS](https://plugins.trac.wordpress.org/log/serkany-direct-checkout-for-iyzico/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3.6

 * Güvenlik: API Anahtarı ve Güvenlik Anahtarı artık veritabanında şifreli (libsodium)
   saklanıyor. Mevcut anahtarlar güncellemeden sonra otomatik şifrelenir.
 * Yeni: Şifreleme anahtarı için wp-config.php’de isteğe bağlı `IYZD_ENCRYPTION_KEY`
   sabiti; tanımlı değilse sitenin WordPress güvenlik anahtarları kullanılır.
 * Kayıtlı anahtarlar çözülemezse (ör. WordPress güvenlik anahtarları değiştiyse)
   kart ile ödeme kapanır ve yönetim panelinde anahtarları yeniden girmeniz istenir.
 * Yeni: iyzico ret kodları için anlaşılır Türkçe mesajlar (limit yetersiz, kart
   internet alışverişine kapalı, taksit yapılamıyor, banka geçici olarak ulaşılamıyor
   vb.). Kayıp/çalıntı kart ve dolandırıcılık kodlarında müşteriye ayrıntı verilmez.
 * Yeni: 3D Secure başarısız olduğunda mdStatus’a göre mesaj (iptal/hatalı şifre,
   kart 3D Secure’a kayıtlı değil, banka sistemi ulaşılamıyor).
 * Sipariş ekranındaki iade hatalarına sık görülen kodlar için açıklama eklendi (
   gün sonu yapılmadı, banka kartı, tutar fazla).
 * Yeni filtre: `iyzd_customer_message`.
 * Yeni: Eklentiyle en az 5 ödeme alındıktan ve 7 gün geçtikten sonra WooCommerce
   sayfalarında, kapatılabilir ve ertelenebilir bir wordpress.org değerlendirme 
   isteği.
 * Pro sürüm “yakında” olarak tanıtılıyor; satış açılana kadar bağlantı gösterilmiyor.
 * readme yenilendi (“Neden bu eklenti?” bölümü, tam Türkçe bölüm); Türkçe banner
   ve ekran görüntüleri eklendi.

#### 1.3.5

 * Plugin renamed to Serkany Direct Checkout for iyzico (new slug and text domain).
 * The 3D Secure page no longer prints the HTML returned by iyzico; the bank form
   is rebuilt from its action URL and fields, escaped, and submitted by the plugin’s
   own script.
 * Webhook fields are sanitized and validated against their expected formats; the
   raw body is never logged.
 * Unsigned webhooks are now rejected by default (setting “Webhook signature”).

#### 1.3.4

 * Bank and card program logos were removed (registered trademarks). The installment
   list shows the bank and program name as text; `iyzd_card_logo_file` can still
   supply a logo URL.
 * Translation and input-sanitization fixes reported by Plugin Check.
 * English readme with an External services section.

#### 1.3.3

 * Pro bilgi bağlantıları yeni satış sayfası adresine (siparis.serkany.online) yönlendirildi.

#### 1.3.2

 * Ödeme ayarları sayfasına, kapatılabilir ve Pro kuruluysa görünmeyen küçük bir
   Pro bilgi kutusu ve eklentiler listesine “Pro’yu incele” bağlantısı eklendi.

#### 1.3.1

 * Yeni filtre `iyzd_installment_note`: taksit sınırlandığında ödeme sayfasında 
   açıklama gösterilebilir (klasik ve blok ödeme).

#### 1.3.0

 * Geliştiriciler için kancalar: `iyzd_max_installment`, `iyzd_admin_options_after`,`
   iyzd_loaded`; gateway’e okuma metotları.
 * Güvenlik: Taksit ayarlardan kapalıyken ya da seçilen taksit izin verilen sayıyı
   aşıyorsa ödeme anında reddedilir.

#### 1.2.4

 * Taksit sorgusuna IP başına hız sınırı; canlı modda imzasız webhook uyarısı; günlükte
   kişisel veri maskeleme.

#### 1.2.0

 * Taksit desteği: BIN’e göre taksit seçenekleri, sunucuda yeniden hesaplama, vade
   farkı ücret kalemi.

#### 1.1.0

 * Webhook desteği (X-IYZ-SIGNATURE-V3 doğrulaması).

#### 1.0.0

 * İlk sürüm: 3D Secure ile ödeme, iptal ve iade, klasik checkout ve blok checkout
   desteği.

## Meta

 *  Version **1.3.6**
 *  Last updated **1 hour ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [iyzico](https://wordpress.org/plugins/tags/iyzico/)[kredi kartı](https://wordpress.org/plugins/tags/kredi-karti/)
   [sanal pos](https://wordpress.org/plugins/tags/sanal-pos/)[taksit](https://wordpress.org/plugins/tags/taksit/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/serkany-direct-checkout-for-iyzico/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/serkany-direct-checkout-for-iyzico/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/serkany-direct-checkout-for-iyzico/reviews/)

## Contributors

 *   [ serkan52 ](https://profiles.wordpress.org/serkan52/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/serkany-direct-checkout-for-iyzico/)