Skip to Content
FluxStore is currently invite-only. Some sections of this documentation are still being written and expanded.
Paymentsiyzico Setup

iyzico Setup

iyzico is Turkey’s leading payment provider. It is the natural choice for Turkish merchants: customers pay by card on iyzico’s hosted checkout form, Turkish cards can pay in installments, and payouts go to your Turkish bank account. Cards from outside Turkey are accepted too.

Step 1: Create an iyzico account

  1. Sign up at iyzico.com  and complete their merchant onboarding - live merchant signup requires a Turkish (+90) phone number
  2. For testing first, create a separate sandbox account at sandbox-merchant.iyzipay.com 

Step 2: Get your API keys

  1. In the iyzico merchant panel, go to Settings > Merchant Settings and find your API key and Secret key (your sandbox panel has its own separate pair)
  2. In FluxStore, go to Dashboard > Gateways and start the iyzico setup
  3. Enter both keys, and choose Sandbox or Live to match where the keys came from
  4. Optionally adjust Enabled installments - the comma-separated installment counts shown to Turkish card holders. Banks charge a fee per installment count, so shorten the list to cap your cost, or set it to 1 to disable installments entirely.
  5. Use the Test keys button to confirm the connection, then finish the wizard

That’s the required setup: iyzico needs nothing configured on their side for payments to work, because FluxStore passes its callback URL with every payment.

The wizard also shows a Notification URL. Adding it gives FluxStore a second, server-to-server confirmation channel, which ensures delivery even if the customer closes their browser before returning to your store.

  1. Copy the Notification URL from the FluxStore wizard
  2. In the iyzico merchant panel, go to Settings > Merchant Settings > Merchant Notifications and paste it (an HTTPS URL is required)

Notifications work as soon as the URL is saved - FluxStore verifies each one directly with iyzico using your API keys, so no further setup is needed. For an additional layer of security, you can also email [email protected] and ask them to enable V3 webhook signatures on your account; FluxStore verifies the signature whenever it is present.

Step 4: Verify it works

Place a test order from your storefront using sandbox keys. On the payment form, use iyzico’s sandbox test card:

FieldValue
Card number5528 7900 0000 0008
Expiry / CVCAny future date, any 3 digits
3D Secure codeDisplayed on the 3D Secure page itself during sandbox payments

Check that the order appears as paid in your FluxStore dashboard after the payment completes. If a payment fails, the customer is returned to checkout with a “payment not completed” message and nothing is charged or delivered.

Stick to the test card above in sandbox. Some other sandbox cards (notably TROY cards) can get stuck at “3Ds Returned to Merchant” in iyzico’s test environment - the 3D Secure step completes, but iyzico never finalizes the charge, so the payment correctly fails.

Refunds

iyzico does not provide any API or notification for refunds, so FluxStore cannot detect them automatically.

To refund an iyzico order: process the refund in the iyzico merchant panel first, then mark the order refunded in your FluxStore dashboard so the items are revoked and your records match. Neither step happens automatically from the other.

Subscriptions

Subscription packages are not currently supported through iyzico. Customers buying a subscription will be offered your other gateways that support them (Stripe or PayPal).

Good to know

  • Foreign cards: cards issued outside Turkey are typically forced through 3D Secure and see higher decline rates than Turkish cards.
  • Installments: installment options only appear for Turkish credit cards, and the customer’s bank may add an installment fee to the total they pay.

Supported currencies

iyzico primarily processes Turkish Lira (TRY) and also supports a small set of other currencies. If you have multi currency checkout enabled, customers will only see iyzico for currencies it supports. See Currencies for the full list showing which currencies work with each provider.

Next steps

PayPal SetupGateway Management