Iyzico

Pour utiliser le iyzico passerelle de paiement dans Mavibot, vous devez obtenir vos identifiants API à partir de 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. Accédez à Paramètres → Clés API (Merchant API Keys).

3. Copiez les identifiants suivants :

   • Clé API

   • Clé secrète

Ces identifiants sont requis 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 Sandbox (test)—aucune configuration supplémentaire n’est requise. Pour accepter les paiements réels, utilisez vos identifiants de production (sans le sandbox- préfixe).

Connexion à 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	Obligatoire	Valeur par défaut / Valeurs 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.

exemple

Bouton de lien de paiement

Pour envoyer un bouton avec un lien de paiement, sélectionnez le Bouton de paiement type 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.

Callbacks de paiement

Après que le client a ouvert le lien de paiement et effectué le paiement, le callback 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 callback 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