iyzico Gateway for Magento 2

Key Features

Turkish card installments (taksit) presented live in checkout, sourced from iyzico's installment-info API

BIN-based installment display: detects the card's issuing bank from the BIN and shows that bank's available plans and any merchant-funded rate

Hosted / iframe checkout using iyzico's CheckoutForm, keeping card entry off your servers to reduce PCI scope

3D Secure authentication enforced on the payment flow with server-side callback verification before order state changes

Refunds and partial refunds issued directly from the Magento admin Credit Memo screen to iyzico's refund endpoint

Built as a proper payment method module implementing Magento's Gateway Command pattern (Authorize, Capture, Refund, Void) via di.xml

Admin configuration through system.xml under Sales → Payment Methods, with API key/secret encrypted in core_config_data and guarded by ACL

Sandbox and production credential profiles for safe testing before go-live, with debug logging toggled per environment

Currency, country and order-total rules so the method shows only for eligible carts (e.g. TRY)

Upgrade-safe implementation using plugins/interceptors and observers instead of core file edits

Compatible with Magento Open Source and Adobe Commerce; headless / PWA Studio and REST/GraphQL exposure available on request

Full installation on your environment plus invoice/credit-memo wiring verified end-to-end

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

iyzico Gateway for Magento 2 is a custom-built payment integration that connects your Magento Open Source or Adobe Commerce checkout to iyzico, Turkey's leading payment gateway. This is not an instant Adobe Commerce Marketplace download — ECOSIRE builds the extension to fit your store's Magento version, theme and checkout flow, installs it under app/code/Ecosire/Iyzico, and supports it afterward.

The integration is built the Magento way: a real payment method module that implements Magento's payment service contracts and Gateway Command pattern (Authorize, Capture, Refund, Void), wired through di.xml, with configuration exposed via system.xml under Stores → Configuration → Sales → Payment Methods and protected by admin ACL. Sensitive credentials (iyzico API key and secret) are stored encrypted in core_config_data.

For Turkish merchants, the headline capability is installments (taksit). We call iyzico's installment-info endpoint using the customer's card BIN and render the available installment plans directly in checkout, so shoppers see real per-bank taksit options before they pay. Checkout runs through iyzico's hosted / iframe (CheckoutForm) flow with 3D Secure authentication, keeping card data off your servers and easing PCI scope.

Order lifecycle is fully wired into Magento: successful authorizations create invoices, refunds and partial refunds are issued from the admin Credit Memo screen straight to iyzico's refund API, and gateway callbacks are verified server-side before any order state changes. We use observers/plugins rather than core edits, so your store stays upgrade-safe.

Every build includes installation on your environment, a sandbox-to-production cutover, and a support window. Because it's bespoke, we can extend it — REST/GraphQL exposure, headless (PWA Studio) checkout, marketplace split payments — on request.

What you get

A custom Magento 2 module (app/code/Ecosire/Iyzico) implementing the iyzico payment method

Installation and configuration on your Magento Open Source or Adobe Commerce environment

Sandbox configuration plus a tested cutover to live iyzico production credentials

Taksit (installment) display wired into your checkout, validated against real card BINs

Refund and partial-refund flow connected to the Magento admin Credit Memo screen

Setup documentation covering configuration paths, ACL, and operational notes

A post-delivery support window for bug fixes and Magento compatibility questions

Source code handover so your team can audit and maintain the module

Who this is for

Turkish online retailer

A merchant selling in TRY who needs bank-accurate taksit options shown at checkout because installment-aware pricing is a primary purchase driver for Turkish shoppers.

Cross-border brand entering Turkey

An international store localizing its Magento checkout for the Turkish market and needing a compliant 3D Secure iyzico flow rather than a generic card form.

Magento agency or in-house dev lead

A technical owner who wants an upgrade-safe, service-contract-based payment module installed and handed over with source, not a black-box marketplace extension.

How iyzico Gateway for Magento 2 Compares

Criterion	ECOSIRE	Custom Build	Competitor
Turkish installments (taksit) with BIN-based plan display	Included	Partial support	Partial support
iyzico hosted/iframe checkout with 3D Secure	Included	Partial support	Included
Built for your exact Magento version, theme and checkout	Included	Included	Not included
Installed and configured on your store by the vendor	Included	Partial support	Not included
Upgrade-safe (service contracts, plugins, no core edits)	Included	Partial support	Partial support
Refund and partial refund from admin Credit Memo to iyzico	Included	Partial support	Included
Source code handover and direct vendor support	Included	Included	Partial support
No upfront in-house Magento payment expertise required	Included	Not included	Partial support

Frequently Asked Questions about iyzico Gateway for Magento 2

Is this an instant download from the Adobe Commerce Marketplace?

No. iyzico Gateway for Magento 2 is build-to-order. ECOSIRE builds the module for your specific Magento version and checkout, installs it under app/code on your environment, and supports it afterward. There is no instant Marketplace download or self-serve license key.

How long does delivery take?

Typical lead time is about 1 to 2 weeks from the time we receive your Magento details and iyzico sandbox credentials. The exact timeline depends on your Magento version (Open Source vs Adobe Commerce), theme/checkout customizations, and whether you need extras like headless or split payments. We confirm a firm date before starting.

What do I need to provide before you start?

Your Magento version and access to a staging environment, plus your iyzico merchant account with sandbox API key and secret. For go-live we also need production credentials. We test fully in sandbox before any cutover to live transactions.

Does it support installments (taksit) for all Turkish banks?

Yes. We call iyzico's installment-info endpoint using the card BIN, so the plans shown reflect what iyzico returns for that issuing bank in real time. Available installment counts and any merchant-funded rates come from your iyzico configuration, not hardcoded values.

What about ongoing support and Magento updates?

Each build includes a support window for bug fixes. Because the module uses service contracts, plugins and observers rather than core edits, it is upgrade-safe across Magento patch releases. Major Magento version upgrades or iyzico API changes can be handled under a maintenance arrangement, and you receive the source code so your own team can maintain it too.