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-V3signature; 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





Installation
- Install the plugin from Plugins Add New and activate it. WooCommerce must be active.
- Go to WooCommerce Settings Payments Kart ile Ödeme (Serkany Direct Checkout for iyzico) and enter:
- 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.
- For installments, enable “Installment support” and choose the maximum number of installments.
- (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”. - 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_KEYconstant if you define it inwp-config.php, otherwise from your site’s WordPress security keys (LOGGED_IN_KEYandLOGGED_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. DefiningIYZD_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_filefilter. -
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. Useiyzd_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.$codeis the iyzico error code or one ofverify,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.
ContributorsTranslate “Serkany Direct Checkout for iyzico – Kartla Ödeme ve Taksit” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by 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_KEYsabiti; 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_filecan 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.
