Garanti BBVA
Pour utiliser le Garanti BBVA (Sanal POS) système de paiement dans Mavibot, vous devez obtenir le terminal POS identifiants 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 3D Secure confirmation.
Obtention des identifiants
Signez un accord avec Garanti BBVA pour le Sanal POS service (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 :
ID marchand (Üye İşyeri No) — votre ID marchand ;
ID terminal — votre ID terminal ;
ID utilisateur de provision — le nom d’utilisateur de provision (généralement PROVAUT ou PROVOOS);
Mot de passe de provision — le mot de passe de l’utilisateur de provision.
Le Clé de boutique (clé 3D Secure) est créée par vous dans le Sanal POS panneau d’administration (Yönetim → 3D Secure). Assurez-vous de l’enregistrer, car elle est également requise pour l’intégration.
Comment connecter Garanti BBVA à Mavibot ?
Dans la Acquisition section de Mavibot, sélectionnez Garanti BBVA et saisissez les informations suivantes :
ID marchand — votre ID marchand.
ID terminal — votre ID terminal.
ID utilisateur de provision — le nom d’utilisateur de provision. S’il est laissé vide, PROVAUT sera utilisé.
Mot de passe de provision — le mot de passe de l’utilisateur de provision.
Store Key — votre clé 3D Secure.
Nom de la boutique — le nom affiché aux clients sur la page de paiement de la banque. Si laissé vide, "Boutique en ligne" sera affiché.
Mode test — activez cette option pour tester l’intégration à l’aide des identifiants de test de la banque. Pour traiter des paiements réels, 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 :
amount
Montant du paiement.
✅
—
description
Description du paiement.
Non
—
currency
Devise du paiement.
Non
TRY (par défaut). Valeurs prises en charge : 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 prises en charge : tr, en
La fonction renvoie une URL de paiement.
Lien de paiement dans un bouton
Pour envoyer un bouton avec un lien de paiement, sélectionnez le Paiement type de bouton 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 workflow
Étape 1. Créez un Démarrage bloc.
Le bloc Démarrage est généralement utilisé pour afficher le premier message de bienvenue dans le workflow, ainsi que toute information introductive dont l’utilisateur a besoin.
Étape 2. Créez le bloc ci-dessous.
Étape 3. Allez dans les Connexion paramètres.
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 Connexion paramètres entre les deuxième et troisième blocs.
Activez la minuterie pour passer automatiquement au bloc suivant.
Étape 6. Dans le troisième bloc, saisissez la fonction dans le Calculateur.
Exemple à copier :
Si vous souhaitez accepter des paiements dans une devise autre que la livre turque (TRY), spécifiez la devise comme indiqué ci-dessous.
Exemple à copier :
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 Facturation fonction.
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 le configurer 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 paiement
Après 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 :
Où :
SDJ91MTKTTsont les 10 premiers caractères de votre Store Key.100correspond au montant du paiement.
Si le paiement échoue, la notification suivante sera envoyée :
Comment envoyer une réponse à un paiement réussi ou échoué
Étape 1. Créez un Déclencheur bloc.
É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.
Sinon, 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 poursuivre le workflow après un paiement réussi, vous pouvez créer un Démarrage bloc au lieu d’un Déclencheur bloc et poursuivre la construction du flux de votre bot à partir de là.
Variables client après un paiement réussi
garanti_callback_data
Informations de paiement reçues du système de paiement.
garanti_payment_completed
"Vrai" si le paiement a été traité avec succès.
garanti_auth_code
Le code d’autorisation de transaction de la banque.
Mis à jour