L'intégration PayTR vous permet d'accepter des paiements via PayTR, un fournisseur de services de paiement turc. Les clients effectuent leurs paiements sur la page de paiement sécurisée de PayTR, où ils peuvent utiliser des cartes bancaires turques et d'autres méthodes de paiement locales.

Obtention des identifiants d'intégration

Avant de connecter PayTR, signez un accord avec PayTR et obtenez l'accès à votre compte marchand.

Dans le menu de gauche, ouvrez Bilgi (Informations) et localisez la section API Entegrasyon Bilgileri. Copiez les valeurs suivantes :

Tableau de bord PayTR Champ Mavibot
Mağaza No Identifiant marchand (merchant_id)
Mağaza Anahtarı Clé marchand (merchant_key)
Mağaza Şifresi Sel marchand (merchant_salt)

Remarque : Ces identifiants sont uniquement disponibles pour l'Ana Kullanıcı (Utilisateur principal) et le Teknik Sorumlu (Responsable technique). Si vous ne voyez pas cette section, demandez au propriétaire du compte principal de vous accorder les autorisations nécessaires.

Vous n'avez pas besoin de configurer une URL de notification de paiement (callback) dans le tableau de bord PayTR. Mavibot envoie automatiquement l'URL de callback avec chaque demande de lien de paiement.

Connexion de PayTR

Ouvrez les paramètres Acquiring dans Mavibot et sélectionnez PayTR.

Saisissez les identifiants suivants :

  • Identifiant marchand (merchant_id) — votre Mağaza No
  • Clé marchand (merchant_key) — votre Mağaza Anahtarı
  • Sel marchand (merchant_salt) — votre Mağaza Şifresi

Enregistrez les paramètres pour finaliser l'intégration.

Génération d'un lien de paiement

Utilisez la fonction de calcul :

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

Paramètres

Paramètre Requis Description
amount ✅ Montant du paiement.
description Non Description du paiement (produit ou service). Affichée sur la page de paiement PayTR.
currency Non Devise du paiement : TL, USD, EUR, GBP ou RUB. Par défaut : TL.
customer_email Non Adresse e-mail du client.
product_name Non Nom du produit affiché sur la page de paiement.
expired Non Durée de vie du lien de paiement en secondes. Si omis, le lien n'expire jamais.
language Non Langue de la page de paiement : tr (turc) ou en (anglais). Par défaut : tr.

La fonction renvoie une URL de paiement.

Remarques

  • Le code de devise TRY est automatiquement converti en TL.
  • Si une devise non prise en charge est spécifiée, TL est utilisée automatiquement.
  • Le nom du produit doit contenir 4 à 200 caractères.
    • Les noms de moins de 4 caractères sont complétés par des points (.).
    • Les noms de plus de 200 caractères sont automatiquement tronqués.

Exemple

Étape 1

Créez un message demandant au client de saisir son adresse e-mail.

Étape 2

Créez le bloc suivant sous le message et ouvrez les paramètres de flèche.

Configurez la Connexion comme suit :

  • Type de correspondance : Expression régulière
  • Activez l'option L'utilisateur saisit des données.
  • Saisissez le nom de la variable : customer_email

Enregistrez les paramètres de Connexion.

Étape 3

Saisissez les paramètres de la fonction dans le calculateur.

Création d'un bouton de paiement

Pour envoyer un bouton de paiement dans Mavibot :

  1. Créez le bloc avec un bouton.

  1. Sélectionnez le type Facturation.
  2. Choisissez PayTR comme fournisseur de paiement.
  3. Spécifiez :
    • Le nom du produit
    • Le montant du paiement
    • La devise
  4. Fournissez éventuellement la variable contenant l'adresse e-mail du client.

Callbacks de paiement

Une fois que le client a effectué le paiement, Mavibot reçoit un callback et le publie dans la conversation.

Paiement réussi

SDJ91MTKTT_success 100

Où :

  • SDJ91MTKTT correspond aux 10 premiers caractères de votre Clé marchand (merchant_key).
  • 100 est le montant du paiement.

Pour réagir aux paiements réussis ou échoués, copiez la valeur du callback et créez un bloc Début (ou bloc Déclencheur).

Saisissez le texte du callback dans le déclencheur.

Créez ensuite un message informant le client si le paiement a réussi ou échoué.

À partir de ce bloc, vous pouvez continuer le flux de votre chatbot selon vos besoins.

Remarque : La configuration du déclencheur montrée dans cet exemple répondra à chaque paiement réussi, car elle utilise uniquement le préfixe du callback sans le montant du paiement.
Si vous souhaitez réagir uniquement à l'achat d'un produit spécifique ou à un montant de paiement particulier, saisissez le texte complet du callback, y compris le montant du paiement, et modifiez le Type de correspondance en Correspondance exacte.

Paiement échoué

SDJ91MTKTT_fail 100

Remarque : Les liens de paiement PayTR sont à usage unique. Après un paiement réussi, le lien est automatiquement désactivé. Générez un nouveau lien de paiement pour chaque nouveau paiement.

Variables client après un paiement réussi

Variable Description
paytr_callback_data Informations de paiement reçues de PayTR.
paytr_payment_completed "True" si le paiement a été traité avec succès.
paytr_merchant_oid Identifiant de transaction PayTR (merchant_oid).