Menu Close
    Hire us Request quote Reading list Switch to dark mode

    Magento 2 Marketplace Iyzico Payment Add-On

    Iyzico Payment Gateway is one of the best payment methods in Turkey. Using iyzico marketplace add-on, the store owner can integrate iyzico payment gateway in Magento 2 Marketplace.

    Magento 2 Marketplace iyzico Payment Gateway helps the marketplace vendors to accept payments online by enabling the iyzico payment method for the product purchase.

    This module supports split payments functionality, where the amount is automatically divided between the sellers and store owner at the time of checkout.

    Customers can use iyzico payment method to pay for their purchases during checkout with ease as the payments done through this gateway are fully secure.


    Features – Marketplace Iyzico Payment Gateway

    • The admin can enable or disable the iyzico Payment Method from admin panel.
    • It supports Split Payment functionality due to which both admin and seller receive the payment at the time of checkout.
    • The seller can become a sub-merchant by entering the necessary information to receive funds when payment is done using Iyzico Payment Gateway.
    • The admin can refund the invoice amount.
    • The sellers can refund Iyzico transactions online.
    • Fully PCI Compliant, no card details submitted to the client server.

    Installation – Marketplace iyzico payment gateway

    Customers will get a zip folder and they have to extract the contents of this zip folder on their system.

    The extracted folder has an src folder, inside the src folder you have the app folder.

    You need to transfer this app folder into the Magento2 root directory on the server as shown below:

    After the successful installation, you have to run these commands in the Magento2 root directory.

    First Command – composer require iyzico/iyzipay-php:~2.0.39

    Second command –  php bin/magento setup:di:compile

    Third Command – php bin/magento setup:static-content:deploy

    After running the commands, you have to flush the cache from the Magento admin panel by navigating through System->Cache management as shown below.

    Module Configuration

    After the successful installation of this extension on the web store, the admin has to navigate through Stores -> Configuration -> Sales -> Payment Methods -> Iyzico Payment.

    The admin set the Marketplace Iyzico Payment configurations as under:

    Enable– The admin can enable or disable the module from here.

    Enable Testing Mode– The admin can enable or disable a testing mode. Testing mode is a mode in which the admin make transactions using iyzico Payment Gateway test cards. Everything in this mode is done for module testing.

    Method Title– In this field, the admin has to enter the title for the Iyzico Payment Method which shall display in the front-end during checkout.

    API Key or ID and API Secret–  In these fields, the admin has to enter the API Key secret key which will be provided by Iyzico Payment Gateway.

    Magento 2 Marketplace iyzico Payment Gateway is purely meant for marketplace sellers.

    If the admin wants to sell his own products on the web store then he has to register as a sub-merchant.

    For registering as a sub-merchant the admin will click on the Register As Sub merchant button.

    This will display the popup and has to enter the details shown in the screenshot below.

    After entering all the details, the admin has to click on Accept iyzico Platform User Agreement and save.

    This is also required if the vendors are using admin’s shipping method because without admin’s registration as a sub-merchant, the customers will not be able to checkout from the cart if the cart contains the seller products with admin shipping.

    Sort Order– Here the admin has to enter the Sort Order for the Payment Gateway.

    Iyzico Account Payment- How to get API Key and Secret Key

    In case of a sandbox account, you have to open and enter your email id and password and click on Log In.

    Once you have logged in account, then under settings you will get API Key and Secret Key.

    WorkFlow at Seller’s End

    First of all the seller has to register himself as a sub-merchant under the iyzico Onboard Sub-Merchant tab.

    On clicking iyzico Onboard Sub-Merchant tab, a form will appear on the screen.

    The seller has to enter his name, email id, address, international bank account number, mobile number.

    After entering all the details, the seller has to Accept iyzico Platform User Agreement and click on save button.

    It is mandatory for all the marketplace vendors to register as sub merchants.

    If the vendors do not register themselves, then they will not receive the payment from iyzico Payment Gateway and the admin has to manually transfer the payment into seller’s account.

    Customer’s End

    In the front end, when a customer adds a product to the cart and clicks on proceed to checkout and fill in the shipping address details as shown in the image below.

    On the Order Review & Payments page Iyzico Payment Method will be visible on the upper left side of the web page.On clicking Iyzico payment method a payment form will appear on the screen.

    If the admin has set Payment Form as Responsive, then a payment form will appear on the screen as shown below.

    Further, the customer will have to add the card details and proceed to Place Order in a usual way or using 3D Secure.

    The customer will have to check the 3D Secure and click on Place Order.

    It redirects the customer to the page as shown in the image below. The customer needs to add the SMS Code and Submit so as to make the payment with 3D Secure.

    Thereafter, a success notification will display for the customer as shown in the image below.

    On clicking the given order number the admin can view the Order Details for the respective order.

    The customer can check the order details under My Orders tab as shown in the image below.

    The customer can see two invoices, as one invoice is for the seller’s transaction of product purchase and the other invoice is for admin shipping transaction.

    On placing the order, the seller can also check the order details under My Order History tab.

    The admin can view orders by navigating through Sales -> Orders, as the order is placed.

    View Order and Transaction Details

    The admin can see the invoices and the transactions by clicking the View option.

    The first invoice is for the product and the second invoice is for shipping.

    The admin can view the transaction details by navigating through Sales -> Transactions.

    By clicking on a transaction, the admin can view details such as iyzico commission amount, sub-merchant price, merchant commission, sub-merchant key etc.

    You can also view the transactions on Iyzico Payment Gateway site under the Transactions tab.

    On clicking Payment ID you can check the details such as payment status, transaction details, card details of a buyer and buyer information.

    Refund Process

    In Magento 2 Marketplace iyzico Payment Gateway, both the admin as well as sellers can process the refund of an order.


    • The sellers can process a refund if admin allows the sellers to manage orders from the admin panel.

    To initiate a refund, the admin has to navigate through Sales -> Invoices. The admin can  view the invoice and click on the Credit Memo button.

    You can also check the refund details by logging into iyzico Payment Gateway site. Under the transactions tab, you have to click on Payment ID.

    The refund details and the exact refund amount for both, seller and admin are visible here.

    That’s all for the Magento2 Marketplace iyzico Payment Gateway. Still, have any issues please raise a ticket or get back to us at

    Current Product Version - 3.0.0

    Supported Framework Version - 2.0.x, 2.1.x, 2.2.x, 2.3.x

    . . .


    Add Your Comment

    Be the first to comment.

    Back to Top
    Hire Us!
    Brief us about your requirements and we'll get back to you.
    Woo! Hooy!
    We have just received your message and our expert will get back to you shortly.
    Send Again

    Table of Content

    Hide Index