Pour utiliser la passerelle de paiement iyzico dans Mavibot, vous devez obtenir vos identifiants API depuis votre compte marchand iyzico et les saisir dans les paramètres d'intégration.

Obtention des identifiants API

  1. Connectez-vous à votre panneau marchand iyzico.
  2. Allez dans Paramètres → Clés API (Clés API marchand).
  3. Copiez les identifiants suivants :
    • Clé API
    • Clé secrète

Ces identifiants sont nécessaires pour connecter iyzico à Mavibot.

Pour les tests, iyzico fournit des identifiants distincts avec le préfixe sandbox-. Si vous saisissez ces identifiants, tous les paiements seront automatiquement traités en mode Bac à sable (test) — aucune configuration supplémentaire n'est requise. Pour accepter des paiements en direct, utilisez vos identifiants de production (sans le préfixe sandbox-).

Connexion d'iyzico

Dans l'onglet Acquisition, sélectionnez iyzico.

Saisissez ensuite :

  • Clé API — votre clé API.
  • Clé secrète — votre clé secrète.

L'intégration est maintenant terminée.

Génération d'un lien de paiement

Fonction de calcul :

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

Paramètres

Paramètre Description Requis Valeurs par défaut / Autorisées
amount Montant du paiement. ✅ —
description Description du paiement. Non —
currency Devise du paiement. Non Par défaut : TRY
Pris en charge : TRY, USD, EUR, GBP, CHF, NOK
customer_email Adresse e-mail du client. Non —
customer_phone Numéro de téléphone du client au format international (par exemple, +905XXXXXXXXX). Non —
full_name Nom complet du client. Non —
identity_number Numéro d'identification du client (pour les clients en Turquie, il s'agit du TCKN). Non —
city Ville du client. Non —
country Pays du client. Non —
address Adresse du client. Non —
product_name Nom du produit affiché sur la page de paiement. S'il est omis, description est utilisé. Non Utilise description
language Langue de la page de paiement. Non Par défaut : en
Pris en charge : en, tr

La fonction renvoie une URL de paiement.

Bouton de lien de paiement

Pour envoyer un bouton avec un lien de paiement, sélectionnez le type Bouton de paiement et choisissez iyzico comme passerelle de paiement. Saisissez ensuite le nom du produit, le montant du paiement et, si nécessaire, la devise du paiement.

Rappels de paiement

Après que le client a ouvert le lien de paiement et effectué le paiement, le rappel suivant est envoyé à la conversation en cas de paiement réussi :

SDJ91MTKTT_success 100

Où :

  • SDJ91MTKTT correspond aux 10 premiers caractères de votre Clé secrète.
  • 100 est le montant du paiement.

Si le paiement échoue, le rappel suivant est envoyé :

SDJ91MTKTT_fail 100

Variables client après un paiement réussi

Variable Valeur
iyzico_callback_data Informations de paiement reçues d'iyzico
iyzico_payment_completed "True" si le paiement a été traité avec succès
iyzico_payment_id ID de paiement iyzico