iyzico

Open Settings › Payments › Other payment providers and choose Set up iyzico (Manage iyzico once it is connected). Other payment providers is also under Payments in the Settings menu.

iyzico takes cards through your own iyzico account, in Turkish lira, US dollars, euros, pounds, Norwegian kroner or Swiss francs (your store’s currency must be one of them). A market that sells in another currency does not offer iyzico at checkout. Storeloom charges nothing for it; iyzico’s own fees apply.

The page has two cards. Connection is where you connect your iyzico account; At checkout has the switch Offer iyzico at checkout and Instructions for customers (optional), shown when they choose it and in their order confirmation. Apply in the bar at the top (it says Unsaved changes while something is not saved) keeps the switch and the instructions; Discard puts them back.

1. In iyzico, open Settings › Merchant Settings › API Keys and copy the API key and secret key.
2. Here, fill them in and choose the Environment: Sandbox or Live. Choose Connect iyzico. Storeloom checks them with iyzico first, then keeps them locked away: never shown again, only the API key’s last four characters and Sandbox or Live.
3. Optional but recommended: in iyzico, under Settings › Merchant Settings › Merchant Notifications, set the notification address shown on this page, so a payment is seen even when the customer closes the page before coming back.
4. Under At checkout, tick Offer iyzico at checkout.

At checkout customers choose Card and other online payments and pay on iyzico’s secure page, in Turkish or English. iyzico then sends them back to their order page, and Storeloom asks iyzico what became of the payment (iyzico’s answer is signed, and checked):

• Paid, and iyzico’s fraud check passed: the order is paid and ships; only then do they get the order confirmation, and you the new-order notification.
• Held for iyzico’s review: their order page says the payment is being checked. Approved, the order is paid; rejected, it is cancelled and its stock goes back.
• Failed: the order is cancelled and its stock goes back; their order page offers Try again.
• Page left unpaid: iyzico’s page is valid for 30 minutes (Pay now on the order page opens a new one after that); about half an hour after it lapses unpaid, Storeloom cancels the order (stock back).

iyzico asks for each buyer’s identity number and mobile number. Your checkout does not ask customers for an identity number, so Storeloom sends iyzico’s placeholder (11111111111), and the order’s phone number, or a placeholder when there is none. Check with iyzico that this suits your account before you go live.

Notifications from iyzico only make Storeloom ask iyzico again; they never decide anything themselves. Refunds of orders paid through iyzico go back through iyzico, in part or in full. A refund goes back through the iyzico account and mode that took the payment: if you have connected another account since, or switched between Sandbox and Live, Storeloom asks you to connect the same account and mode again before it refunds. Disconnect forgets the details and stops offering iyzico. iyzico cannot pay subscription renewals yet. Only the owner connects or disconnects iyzico.