Um das iyzico-Zahlungsgateway in Mavibot zu verwenden, müssen Sie Ihre API-Anmeldeinformationen aus Ihrem iyzico-Händlerkonto abrufen und in den Integrationseinstellungen eingeben.

API-Anmeldeinformationen abrufen

  1. Melden Sie sich in Ihrem iyzico-Händlerpanel an.
  2. Gehen Sie zu Einstellungen → API-Schlüssel (Händler-API-Schlüssel).
  3. Kopieren Sie die folgenden Anmeldeinformationen:
    • API-Schlüssel
    • Geheimer Schlüssel

Diese Anmeldeinformationen sind erforderlich, um iyzico mit Mavibot zu verbinden.

Für Testzwecke stellt iyzico separate Anmeldeinformationen mit dem Präfix sandbox- bereit. Wenn Sie diese Anmeldeinformationen eingeben, werden alle Zahlungen automatisch im Sandbox (Test)-Modus verarbeitet – es ist keine zusätzliche Konfiguration erforderlich. Um Live-Zahlungen zu akzeptieren, verwenden Sie Ihre Produktionsanmeldeinformationen (ohne das Präfix sandbox-).

iyzico verbinden

Wählen Sie im Tab „Acquiring“ die Option iyzico.

Geben Sie dann Folgendes ein:

  • API-Schlüssel — Ihr API-Schlüssel.
  • Geheimer Schlüssel — Ihr geheimer Schlüssel.

Die Integration ist nun abgeschlossen.

Funktion des Rechners:

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

Parameter

Parameter Beschreibung Erforderlich Standard / Zulässige Werte
amount Zahlungsbetrag. ✅ —
description Zahlungsbeschreibung. Nein —
currency Zahlungswährung. Nein Standard: TRY
Unterstützt: TRY, USD, EUR, GBP, CHF, NOK
customer_email E-Mail-Adresse des Kunden. Nein —
customer_phone Telefonnummer des Kunden im internationalen Format (z. B. +905XXXXXXXXX). Nein —
full_name Vollständiger Name des Kunden. Nein —
identity_number Identifikationsnummer des Kunden (für Kunden in der Türkei ist dies die TCKN). Nein —
city Stadt des Kunden. Nein —
country Land des Kunden. Nein —
address Adresse des Kunden. Nein —
product_name Produktname, der auf der Zahlungsseite angezeigt wird. Wenn nicht angegeben, wird description verwendet. Nein Verwendet description
language Sprache der Zahlungsseite. Nein Standard: en
Unterstützt: en, tr

Die Funktion gibt eine Zahlungs-URL zurück.

Um einen Button mit einem Zahlungslink zu senden, wählen Sie den Typ Zahlungsbutton und wählen Sie iyzico als Zahlungsgateway aus. Geben Sie dann den Produktnamen, den Zahlungsbetrag und gegebenenfalls die Zahlungswährung ein.

Zahlungs-Callbacks

Nachdem der Kunde den Zahlungslink geöffnet und die Zahlung abgeschlossen hat, wird bei erfolgreicher Zahlung der folgende Callback an die Konversation gesendet:

SDJ91MTKTT_success 100

Wobei:

  • SDJ91MTKTT die ersten 10 Zeichen Ihres geheimen Schlüssels sind.
  • 100 der Zahlungsbetrag ist.

Wenn die Zahlung fehlschlägt, wird der folgende Callback gesendet:

SDJ91MTKTT_fail 100

Kundenvariablen nach erfolgreicher Zahlung

Variable Wert
iyzico_callback_data Von iyzico erhaltene Zahlungsinformationen
iyzico_payment_completed "True", wenn die Zahlung erfolgreich verarbeitet wurde
iyzico_payment_id iyzico-Zahlungs-ID