Enabling iyzico

Connect iyzico under Settings > Payments to accept payments through iyzico's hosted checkout form. Customers selecting iyzico at checkout are redirected to iyzico to complete their card payment and then return to your store.

Before you start

• Sign in as the store owner or with a staff account that has Payments permission. Staff without Payments permission cannot open the iyzico settings page.
• Have an active iyzico merchant account or sandbox test account. iyzico is designed for merchants operating in Türkiye, and foreign-currency collection (such as USD or EUR) requires approval on your iyzico merchant account.
• Check that your store currency is supported. In Nevuto, iyzico is available for stores using USD, EUR, GBP, RUB, CHF, NOK or TRY. While this guide uses USD examples, a USD store currency does not replace iyzico's merchant registration requirements.
• Prepare a separate iyzico sandbox account at sandbox-merchant.iyzipay.com to test payments before using live credentials.

Open the iyzico setup

1. In your Nevuto admin, go to Settings > Payments.
2. Click Add payment and select Add payment provider.
3. In the Add payment method modal, enter iyzico in Enter payment method. Clear any category filter if it hides the result.
4. Click the iyzico card to open its setup page.

If iyzico has already been added, click its row in Settings > Payments or open the row's three-dot menu and select Manage. Opening the setup page does not save or activate the provider. Select any screenshot to view it at full size.

Match iyzico credentials to the Nevuto fields

In your live or sandbox iyzico merchant panel, open Settings > Merchant Settings to view your API credentials. See iyzico's authentication documentation for details on how iyzico pairs API keys and secret keys.

Nevuto maps iyzico's credentials to these fields:

• Public key: Your live iyzico API Key.
• Secret key: Your live iyzico Secret Key.
• Sandbox public key (inside Sandbox mode): Your sandbox iyzico API Key (usually prefixed with sandbox-).
• Sandbox secret key (inside Sandbox mode): Your sandbox iyzico Secret Key (usually prefixed with sandbox-).

Always pair the API Key and Secret Key from the same iyzico account and environment. Never share your Secret Key in screenshots, emails or support messages.

Configure sandbox mode

1. Under Configure API keys, click Sandbox mode to expand the test fields.
2. Paste your sandbox API Key into Sandbox public key.
3. Paste your sandbox Secret Key into Sandbox secret key. You can leave the live Public key and Secret key fields blank while setting up only sandbox testing.
4. Switch on Enable sandbox mode so Nevuto connects to iyzico's sandbox environment.
5. Switch on Enable payment status if you want iyzico displayed at checkout for your test.
6. Review Payment Limits (and Instalments once the provider has been saved).
7. Click Submit in the upper-right corner and wait for the save confirmation.

When you click Submit, Nevuto verifies the active credential pair with iyzico before storing the configuration. On a successful initial setup, Nevuto returns to Settings > Payments. Reopen iyzico to confirm that your settings were saved.

The Payments table displays Active or Inactive for checkout visibility separately from Sandbox or Live for the credential environment.

This screenshot shows an unsaved example. All four credential fields are intentionally empty and Enable payment status is off. Enter your own iyzico sandbox API Key and Secret Key before submitting.

Test the hosted checkout flow

Use iyzico's official test cards when testing in sandbox mode; real cards do not work in the iyzico sandbox environment.

To verify the checkout flow after saving your sandbox setup:

1. Create a test cart on your storefront and proceed to checkout.
2. Select iyzico and continue to iyzico's hosted checkout form.
3. Enter an official iyzico sandbox test card with a future expiration date and valid CVV, and follow the sandbox 3D Secure verification prompt if shown.
4. Return to your store and confirm that the order is recorded as paid in Nevuto and appears in your iyzico sandbox merchant panel.
5. If you enabled Instalments, test an installment-eligible sandbox credit card and verify how the selected installment count and charged amount are recorded.
6. Also test cancelling or using a declined test card so you know how failed attempts behave.

Set payment limits and installments

Payment Limits restricts when iyzico is offered at checkout based on cart total. Turn on Payment Limits to enter a Minimum Cart Amount and Maximum Cart Amount in your store currency. The minimum cannot exceed the maximum.

After you save your iyzico credentials for the first time, reopening the iyzico settings page also shows the Instalments card below Payment Limits. Instalments controls whether iyzico can offer multi-installment plans (2, 3, 6, 9 or 12 installments in addition to single payment) on its hosted payment form. When Instalments is off, Nevuto restricts the checkout form to a single payment. Note that installment availability at checkout still depends on the customer's card, currency and your agreement with iyzico, and installment commissions apply according to your iyzico merchant pricing.

Switch to live payments

Once your sandbox tests pass and your live iyzico merchant account is approved:

1. Sign in to your live iyzico merchant panel and copy your live API Key and Secret Key from Settings > Merchant Settings.
2. In Nevuto, open Settings > Payments and select iyzico.
3. Enter your live API Key in Public key and your live Secret Key in Secret key.
4. Expand Sandbox mode and turn off Enable sandbox mode so Nevuto uses your live credentials.
5. Review Enable payment status, Payment Limits and Instalments.
6. Click Submit and verify that iyzico appears as Active with Live mode on the Payments page.

Your sandbox keys remain in their separate fields; the Enable sandbox mode toggle determines which environment Nevuto uses.

Edit or deactivate iyzico

To update your keys, limits or installment setting, open iyzico from Settings > Payments, make your changes and click Submit. The Submit button remains disabled until the form has unsaved edits.

To stop offering iyzico at checkout, turn off Enable payment status and submit, or open the three-dot menu on the iyzico row in Settings > Payments and click Deactivate. Choosing Delete from the three-dot menu removes the saved iyzico configuration. Deactivating or deleting stops new checkouts from using iyzico without cancelling existing orders or issuing refunds. For orders paid through iyzico after refund support was added, Nevuto records item-level transaction IDs so refunds can be processed per basket item; older orders without stored item transaction IDs must be refunded directly from the iyzico merchant panel.

Troubleshooting