iyzico Payments (3DS, Installments, Marketplace)

Add-on ID: kv_iyzico_payments · Edition: CS-Cart & Multi-Vendor · Latest version: 1.1.1 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view

Accept card payments in TRY and foreign currencies with iyzico. The customer pays on iyzico’s PCI-compliant form, which you can embed in your store page, open as a popup, show in an iframe, or open as a redirect. 3D Secure, installments and the iyzico wallet (“Pay with iyzico”) are supported. You can refund or cancel payments from the order page. On Multi-Vendor, the add-on can split every payment between the marketplace and its vendors through iyzico Marketplace sub-merchants.

Key features

• Checkout Form with 3D Secure, in four display modes: embedded (responsive), popup, iframe or hosted page redirect. Card data never touches your server.
• Pay with iyzico: the customer pays with the iyzico wallet or a saved card. Set it up as a second payment method.
• Installments: you choose which installment counts are allowed (2, 3, 6, 9, 12). At checkout, a table lists the monthly and total amounts per card family (Bonus, World, Maximum, Axess, …), read live from iyzico for the cart total.
• Installment interest on the order. When the customer pays installment interest, the add-on can add it to the order as a payment surcharge, so the order total matches the bank statement.
• Exact basket mapping. iyzico rejects a payment unless the basket item prices add up exactly to the amount charged. The add-on maps products and shipping, and spreads discounts, gift certificates, reward points, taxes and currency rounding over the basket items to the cent.
• TRY, USD, EUR and GBP. Charge either in the store’s primary currency or in the currency the customer selected.
• Buyer identity (TCKN). Send the default 11111111111, or read the number from a customer profile field.
• Verified results. The add-on retrieves every payment result from iyzico on the server and checks its signature, basket ID, currency and amount. Callbacks and webhooks are idempotent, so an order is never processed twice.
• Webhook support (X-Iyz-Signature-V3). Payments complete even when the customer closes the browser on the iyzico page.
• Refunds and cancels from the admin order page: full or partial refunds, and same-day cancels. Every refund and cancel is kept in a history.
• Multi-Vendor marketplace mode. You and your vendors enter IBAN and identity/tax data on the vendor profile, and the add-on creates or updates each vendor’s iyzico sub-merchant. Every basket item carries the vendor’s subMerchantPrice, which is the item amount minus the commission CS-Cart calculated for the vendor order. Items can be approved for payout automatically when a vendor order reaches a status you choose, or manually.
• Masked logging in Administration → Logs (type iyzico). Identity numbers, e-mails, phones, IBANs, tokens and keys are masked.
• Sandbox and live keys are stored side by side, so switching the mode needs only one click. A Test connection button checks the keys.
• English texts.

Compatibility

CS-Cart / Multi-Vendor	4.17.2 – 4.21.x (tested on CS-Cart 4.17.2, Multi-Vendor 4.17.2 and Multi-Vendor 4.21.2)
PHP	7.2.5 – 8.3 (the code is PHP 7.4-compatible; tested with PHP 8.1 and 8.3)
PHP extensions	cURL with OpenSSL (TLS 1.2), JSON
Themes	Responsive and Bright theme, plus child themes based on Responsive
iyzico account	A merchant account (standard or Marketplace). Sandbox keys work for testing.

How a payment works

1. The customer chooses iyzico at checkout. An installment table for the cart total can be shown under the method.
2. When the order is placed (status Incomplete), the add-on maps it to an iyzico Checkout Form request and sends the customer to the payment form. The request includes buyer, addresses, basket items and the callback URL.
3. The customer pays, with 3D Secure and installments if chosen.
4. iyzico posts a token to the callback URL. The add-on retrieves the result from the iyzico API, verifies it, stores the item transaction IDs and sets the order status: Processed if paid, Open while iyzico runs a fraud review, Failed if declined.
5. The customer lands on the regular order confirmation page. If the customer never comes back, the iyzico webhook (or the Check payment status button) completes the order.

Documentation

• Installation
• Configuration: iyzico merchant panel steps, payment method options, add-on settings
• Usage: checkout, installments, refunds and cancels, sandbox testing, Multi-Vendor marketplace mode
• Developer guide
• FAQ

Trademarks

iyzico is a trademark of its owner. This add-on is made by Kavio Labs and is not endorsed by or affiliated with iyzico. The name iyzico describes compatibility only.