BILLmanager 6
Documentation
/
BILLmanager 6
/
Provider settings
/
Payment gateways
/
Iyzico

Iyzico

To use the Iyzico payment module, register in the payment system and make settings on the payment system side and in BILLmanager.

Payment methods support
Bank cardsCashE-walletsMobile paymentsOnline banking

Mastercard,
Visa,
Troy





Supported features
Payments return
Recurring payments
Subscriptions

Setup on the Iyzico side

  1. Log in to your Iyzico client area.
  2. Enter Settings → Merchant Settings.
  3. Copy API Key and Secret Key from the API section.
  4. In Merchant Notification:
    1. Enable payment notifications.
    2. Specify the address in the format https://{BILLmanager_URL}/mancgi/iyzicowebhook in Merchant Notification Url.

    Setup on the BILLmanager side

    The module is installed from the latest available version of the product and requires updating the BILLmanager platform, as the module version cannot be higher than the platform version.

    The payment system has mandatory fields to be filled in by the payer. To create missing fields, enter Directories → Countries → select a country → click Paramaters → click Add:

    Name

    Internal name

    payer's email

    email

    Payer’s name

    name

    TIN

    vatnum

    City

    city_physical

    Country

    country_physical_name

    Address

    address_physical


    To create a payment module, enter Provider → Payment methods → click Add. The payment module adding wizard consists of the following steps:

    1. Select the payment method: "Iyzico".
    2. Integration settings. Specify the data for integration:
      The Client in the payment system parameter offers to use an existing account on the side of the payment system or create a new one.
      Selecting the Create New option displays a link to a form in the Iizico registration system.
      If using an Existing account, enter the data for integration with the payment system:
      • URL API — if necessary, specify the address of the API server. You can leave the field blank, then the default value will be used;
      • API key — specify the API Key from the client area of the payment system;
      • API secret key — specify the Secret Key from the client area of the payment system;
      • Use 3D Secure — activate this option so that the module requests authorization via 3D Secure when paying;
      • Allow refunds — activate the option to allow payment refunds.
    3. Payment method settings.Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.

    Additional information

    Payment refund

    To allow payment returns, enter Provider → Payment methods → click Edit → Allow refund option. Refund is supported for payments with the “Credited” status.

    Logging

    Logs of interaction between the billing platform and Iyzico are written to files:

    • /usr/local/mgr5/var/pmiyzico.log — log file of payment module settings, refunds, checking payment statuses;
    • /usr/local/mgr5/var/iyzicopayment.log — payment log file;
    • /usr/local/mgr5/var/iyzicowebhook.log — log file for handling notifications from iyzico.