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

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