Pour utiliser le système de paiement Garanti BBVA (Sanal POS) dans Mavibot, vous devez obtenir les identifiants du terminal POS virtuel auprès de la banque et les saisir dans les paramètres d'intégration. Le paiement est traité sur la page sécurisée de la banque avec confirmation 3D Secure.

Obtention des identifiants

Signez un contrat avec Garanti BBVA pour le service Sanal POS (POS virtuel). Lors de l'activation du service, demandez à la banque d'activer Ortak Ödeme (page de paiement partagée) pour votre terminal. Sans cette fonctionnalité, les paiements via la page de paiement de la banque ne fonctionneront pas.

La banque vous fournira :

  • Merchant ID (Üye İşyeri No) — votre identifiant marchand ;
  • Terminal ID — votre identifiant de terminal ;
  • Provision User ID — le nom d'utilisateur de provision (généralement PROVAUT ou PROVOOS) ;
  • Provision Password — le mot de passe de l'utilisateur de provision.

La Store Key (clé 3D Secure) est créée par vous dans le panneau de gestion Sanal POS (Yönetim → 3D Secure). Assurez-vous de la sauvegarder, car elle est également requise pour l'intégration.

Comment connecter Garanti BBVA à Mavibot ?

Dans la section Acquiring de Mavibot, sélectionnez Garanti BBVA et saisissez les détails suivants :

  • Merchant ID — votre identifiant marchand.
  • Terminal ID — votre identifiant de terminal.
  • Provision User ID — le nom d'utilisateur de provision. Si laissé vide, PROVAUT sera utilisé.
  • Provision Password — le mot de passe de l'utilisateur de provision.
  • Store Key — votre clé 3D Secure.
  • Store Name — le nom affiché aux clients sur la page de paiement de la banque. Si laissé vide, "Online store" sera affiché.
  • Test Mode — activez cette option pour tester l'intégration avec les identifiants de test de la banque. Pour traiter les paiements en direct, cette option doit être désactivée.

L'intégration est maintenant terminée.

Génération d'un lien de paiement

Fonction de calcul :

get_garanti_payment_url(amount, description, currency, customer_email, 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 TRY (par défaut). Valeurs autorisées : TRY, USD, EUR, GBP, JPY
customer_email Adresse e-mail du client. Non —
language Langue de la page de paiement. Non tr (par défaut). Valeurs autorisées : tr, en

La fonction retourne une URL de paiement.

Lien de paiement dans un bouton

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

Exemple 1 : Configuration du flux de travail

Étape 1. Créez un bloc Début.

Le bloc Début est généralement utilisé pour afficher le premier message de bienvenue dans le flux de travail, ainsi que toute information d'introduction dont l'utilisateur a besoin.

Étape 2. Créez le bloc illustré ci-dessous.

Étape 3. Accédez aux paramètres de Connexion.

Vous aurez besoin de l'expression régulière suivante pour vérifier que le client a saisi une adresse e-mail valide :

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

Activez également l'option L'utilisateur saisit des données et saisissez customer_email.

Étape 4. Saisissez le message dans le deuxième bloc.

Étape 5. Créez un troisième bloc et ouvrez les paramètres de Connexion entre le deuxième et le troisième bloc.

Activez la minuterie pour passer automatiquement au bloc suivant.

Étape 6. Dans le troisième bloc, saisissez la fonction dans le Calculateur.

Exemple à copier :

amount = 1000
description = "Product1 is a product of great reliability!"
link = get_garanti_payment_url(amount, description, none, customer_email, none)

Si vous souhaitez accepter les paiements dans une devise autre que la livre turque (TRY), spécifiez la devise comme indiqué ci-dessous.

Exemple à copier :

amount = 1000
description = "Product1 is a product of great reliability!"
currency = "USD"
link = get_garanti_payment_url(amount, description, currency, customer_email, none)

Exemple 2. Bouton de facturation

Cet exemple est presque identique à l'Exemple 1.

Cependant, au lieu de créer un troisième bloc avec une fonction pour générer le lien de paiement, vous pouvez créer un bouton dans le deuxième bloc.

Dans la fenêtre qui s'ouvre :

  • Saisissez le texte du bouton.
  • Sélectionnez la fonction Facturation.
  • Sélectionnez Garanti BBVA comme fournisseur de paiement.

Saisissez ensuite les éléments suivants :

  • Nom du produit.
  • Montant du paiement.
  • Devise (facultatif).
  • Nom complet du client (facultatif). Vous pouvez configurer cela de la même manière que vous avez configuré la saisie de l'e-mail du client.
  • E-mail du client — saisissez la variable #{customer_email}.

Cliquez ensuite sur Ajouter.

Notifications après le paiement

Une fois que le client a suivi le lien de paiement et effectué le paiement, une notification (callback) sera envoyée à la conversation.

Pour un paiement réussi :

SDJ91MTKTT_success 100

Où :

  • SDJ91MTKTT correspond aux 10 premiers caractères de votre Store Key.
  • 100 est le montant du paiement.

Si le paiement échoue, la notification suivante sera envoyée :

SDJ91MTKTT_fail 100

Comment envoyer une réponse à un paiement réussi ou échoué

Étape 1. Créez un bloc Déclencheur.

Étape 2. Dans le champ de condition, saisissez le texte de notification SDJ91MTKTT_success — sans le montant du paiement — si vous souhaitez réagir à chaque paiement.

Dans ce cas, le Type de correspondance doit être défini sur Par mots-clés.

Alternativement, saisissez l'intégralité du texte de callback dans le champ Déclencheur si vous souhaitez réagir à un paiement spécifique. Dans ce cas, le Type de correspondance doit être défini sur Correspondance exacte.

Si vous souhaitez continuer le flux de travail après un paiement réussi, vous pouvez créer un bloc Début au lieu d'un bloc Déclencheur et continuer à construire votre flux de bot à partir de là.

Variables client après un paiement réussi