- Comment se connecter
- Comment créer un lien
- Comment traiter le résultat
- Comment effectuer des paiements de test
Comment se connecter
Pour connecter le système de paiement Fondy, vous aurez besoin d'un identifiant marchand et d'une clé secrète. Après les avoir reçus, rendez-vous dans les paramètres de Mavibot.
Dans Mavibot, ouvrez la section des systèmes de paiement, sélectionnez Fondy. Vous devez saisir les données reçues.
Pour générer un lien de paiement, vous devez définir la valeur de la variable payment_sum (par exemple 150 ou 100.55 (avec un point !)), immédiatement après, la variable fondy_pay_url apparaît. Cette variable peut être affichée avec un lien ou placée sur un bouton avec le texte « Payer ».
Le lien a la forme :
De plus, avant de définir la valeur de payment_sum, vous pouvez spécifier les variables optionnelles suivantes pour configurer le paiement.
Le paramètre par défaut est UAH, si vous avez besoin d'une autre devise, vous devez définir la valeur de la variable currency
currency - Devise de la commande.
Valeurs valides :
UAH - Hryvnia ukrainienne
RUB - Rouble russe
USD - Dollar américain
EUR - Euro
GBP - Livre sterling
CZK - Couronne tchèque
payment_description - Description de la commande
session_timeout - Durée de vie de la commande en secondes.
Par défaut (36000 secondes = 10 heures).
language - Langue de la page de paiement :
ru - Russe
uk - Ukrainien
en - Anglais
lv - Letton
fr - Français
cs - Tchèque
ro - Roumain
it - Italien
sk - Slovaque
pl - Polonais
es - Espagnol
hu - Hongrois
de - Allemand
Comment créer un lien
Créez un lien pour le paiement de 122 UAH (hryvnia par défaut)
Veuillez noter :
- Spécifiez d'abord les paramètres optionnels payment_description, etc.
- Et enfin, attribuez la valeur de la variable payment_sum
Notez que nous définissons d'abord les variables supplémentaires pour les paramètres, puis payment_sum. Vous pouvez définir les variables plus tôt dans une chaîne, pas dans un seul bloc, ceci est un exemple.
Ensuite, à l'endroit approprié, imprimez la variable fondy_pay_url, qui contient le lien.
Comment traiter le résultat
Après un paiement réussi, des callbacks arriveront dans le bot, sur lesquels vous pouvez comprendre qu'un paiement réussi a eu lieu. Ces callbacks dans le système sont visibles comme des messages de l'utilisateur, de sorte qu'ils ne peuvent pas être envoyés par l'utilisateur. Ils se composent des 5 premiers caractères de la clé secrète et du mot success, par exemple : h4fd56_success
Si le mot de passe fait moins de 5 caractères, le mot de passe sera utilisé en entier, par exemple pour les paiements de test, le mot de passe est test, alors le callback sera test_success
Ces callbacks NE SONT PAS VISIBLES pour l'utilisateur, ils sont affichés uniquement à l'opérateur
Le type de comparaison doit être « Correspondance exacte »
De plus, après un paiement réussi, la variable fondy_payment_completed est définie sur True.
Par exemple, vous pouvez créer un bloc de traitement de paiement réussi avec une condition et imprimer le message correspondant à l'utilisateur :
Une fois le paiement terminé, la variable fondy_callback_data sera ajoutée au client, contenant les données de réponse du système de paiement pour la transaction terminée. Vous pouvez extraire les données nécessaires du dictionnaire à l'aide de la méthode get.
Pour effectuer un paiement répété, vous devez réinitialiser payment_sum, le lien précédemment généré, et après avoir réinitialisé la variable payment_sum pour obtenir un nouveau lien. Vous pouvez spécifier une valeur précédente.
Comment effectuer des paiements de test
Données de test au moment de la publication de la documentation :
Identifiant marchand : 1396424
Mot de passe : test
Numéros de carte de test
44445566661111 - Réussi
4444111166665555 - Refus
Période de validité et CVV2 quelconques
Si quelque chose ne fonctionne pas, comparez les données avec celles du site officiel : https://docs.fondy.eu/ru/docs/page/2/2