Iyzico

To use the iyzico payment gateway in Mavibot, you need to obtain your API credentials from your iyzico merchant account and enter them in the integration settings.

Obtaining API Credentials

1. Sign in to your iyzico Merchant Panel.

2. Go to Settings → API Keys (Merchant API Keys).

3. Copy the following credentials:

   • API Key

   • Secret Key

These credentials are required to connect iyzico to Mavibot.

For testing, iyzico provides separate credentials with the sandbox- prefix. If you enter these credentials, all payments will automatically be processed in Sandbox (test) mode—no additional configuration is required. To accept live payments, use your production credentials (without the sandbox- prefix).

Connecting iyzico

In the Acquiring tab, select iyzico.

Then enter:

• API Key — your API key.

• Secret Key — your Secret Key.

The integration is now complete.

Generating a Payment Link

Calculator function:

get_iyzico_payment_url(amount, description, currency, customer_email, customer_phone, full_name, identity_number, city, country, address, product_name, language)

Parameters

Parameter	Description	Required	Default / Allowed Values
amount	Payment amount.	✅	—
description	Payment description.	No	—
currency	Payment currency.	No	Default: TRY Supported: TRY, USD, EUR, GBP, CHF, NOK
customer_email	Customer's email address.	No	—
customer_phone	Customer's phone number in international format (for example, +905XXXXXXXXX).	No	—
full_name	Customer's full name.	No	—
identity_number	Customer's identification number (for customers in Turkey, this is the TCKN).	No	—
city	Customer's city.	No	—
country	Customer's country.	No	—
address	Customer's address.	No	—
product_name	Product name displayed on the payment page. If omitted, description is used.	No	Uses description
language	Language of the payment page.	No	Default: en Supported: en, tr

The function returns a payment URL.

example

Payment Link Button

To send a button with a payment link, select the Payment Button type and choose iyzico as the payment gateway. Then enter the product name, payment amount, and, if necessary, the payment currency.

Payment Callbacks

After the customer opens the payment link and completes the payment, the following callback is sent to the conversation upon a successful payment:

SDJ91MTKTT_success 100

Where:

• SDJ91MTKTT is the first 10 characters of your Secret Key.

• 100 is the payment amount.

If the payment fails, the following callback is sent:

SDJ91MTKTT_fail 100

Customer Variables After a Successful Payment

Variable	Value
iyzico_callback_data	Payment information received from iyzico
iyzico_payment_completed	"True" if the payment was successfully processed
iyzico_payment_id	iyzico payment ID