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 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
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. 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
- 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.
- Open the iyzico card under All Modules and tick Status.
- Replace the sample values in API Anahtarı and Güvenlik Anahtarı with your own keys, and leave Test Modu ticked.
- Click Save Changes. The method now appears on the payment step.
Run a test payment
- Place a small order as a client and choose iyzico on the payment step.
- Pay with an iyzico sandbox test card on the form that opens.
- 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
- Untick Test Modu.
- 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.
- Click Save Changes, then pay one low-value invoice for real and confirm the money reaches your iyzico account.
Offer installments
- Write the counts you have agreed with iyzico into Taksit Seçeneği Göster, such as 3,6,9.
- Click Save Changes.
- The iyzico form now shows those counts to a client whose card supports them.
- An installment plan that costs more adds the difference to the invoice as a separate line. The order total follows it.
- A filled Converting Currency field switches that off, so the difference stays off the invoice.
Things to Watch
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.
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 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.
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
Merci pour votre retour !
Notre équipe d'assistance est disponible 24h/24 pour tout ce que vous ne trouvez pas ci-dessus.