- Inscription rapide et confirmation du commerçant
- Inscription du commerçant pour les particuliers sans site web
- Pourcentage unique pour les particuliers et les personnes morales – 2,5 %
- Disponibilité de Google Play et Apple Pay
Comment se connecter
Pour connecter le système de paiement Wayforpay, vous aurez besoin de 3 valeurs :
- l'identifiant du commerçant
- la clé secrète du commerçant
- le nom de domaine du site web du commerçant.
Accédez à votre compte personnel -> paramètres de la boutique https://m.wayforpay.com/mportal/merchant/list
Copiez les données et allez dans les paramètres de Mavibot.
Ouvrez la section "Acquiring", sélectionnez wayforpay.
Vous devez saisir les données reçues dans le formulaire qui s'ouvre :
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, si le montant est fractionnaire, le montant est séparé par un point) :
Immédiatement après, la variable wayforpay_pay_url apparaîtra. Cette variable peut être affichée dans le message avec un lien ou placée sur le bouton avec le texte "Payer" :
Option 1. Le lien de paiement dans le bouton :
Option 2. Le lien de paiement est dans le champ url de la pièce jointe :
Le lien ressemble à :
https://secure.wayforpay.com/invoice/id1bbb2ad0375
Par défaut, USD (dollars) est défini, si vous avez besoin d'une autre devise, vous devez définir la valeur de la variable currency.
De plus, avant de définir la valeur de la variable payment_sum, vous pouvez définir les variables facultatives suivantes pour configurer le paiement.
currency - est la devise par défaut de la commande, UAH (les valeurs possibles sont USD, EUR, RUB)
session_timeout - Durée de vie du lien en secondes, par défaut 3600 (1 heure)
product_name - nom du produit
language - langue de la page de paiement, par défaut UA (les valeurs possibles sont RU, EN)
buyer_name - nom du client
buyer_email - email du client
buyer_first_name - prénom du client
buyer_last_name - nom de famille du client
Voici à quoi ressemble la page de paiement avec un lien.
Créons un lien de paiement d'un montant de 1 USD et d'une durée de vie de 2 heures :
Attention :
- D'abord, spécifiez les paramètres facultatifs product_name etc.
- Et enfin, attribuez la valeur de la variable payment_sum.
Veuillez noter que nous définissons d'abord les variables pour les paramètres, puis payment_sum. Les variables peuvent être définies plus tôt dans la chaîne, plutôt que dans un seul bloc, ceci est un exemple.
Ensuite, dans le bloc suivant, nous affichons la variable wayforpay_pay_url, qui contient un lien (par exemple, un lien dans le texte) :
Le bot fonctionnera comme suit :
Comment traiter le résultat
Après un paiement réussi, des callbacks seront envoyés au bot, qui vous informeront que le paiement a réussi. Vous voyez ces callbacks dans le système comme des messages de l'utilisateur, pour que l'utilisateur ne puisse pas les envoyer, ils sont composés des 10 premiers caractères de la clé secrète et du suffixe _success, par exemple : flk3409ref_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 wayforpay_payment_completed est définie sur True.
Par exemple, vous pouvez traiter un paiement réussi dans un bloc conditionnel et afficher le message correspondant à l'utilisateur :
Si vous ne voulez pas faire sortir le client du schéma principal du chatbot, utilisez le bloc "Non-state with a condition". Vous ne pouvez pas accéder à ce bloc, donc le client ne sera pas sorti de l'entonnoir principal après le paiement et recevra une notification de paiement réussi.
Et si vous avez besoin de continuer l'entonnoir avec une réaction à un paiement réussi, utilisez le bloc "Start condition", alors le client passera du bloc de paiement au bloc "Start condition", à partir duquel vous pouvez continuer l'entonnoir.
Plus d'informations sur les blocs conditionnels sont fournies dans l'article du même nom
Une fois le paiement terminé, la variable wayforpay_callback_data sera ajoutée au client, contenant les données de la réponse du système de paiement à la transaction terminée. Vous pouvez extraire les données nécessaires du dictionnaire résultant à l'aide de la méthode get.
Fonctions pour travailler avec la calculatrice
Pour les paiements récurrents
wayforpay_recurrent_payment(amount, currency, session_timeout, product_name, language, buyer_name, buyer_email, regular_date_next, regular_date_end, regular_count, regular_mode) - génère un lien pour un paiement récurrent.
Annulation du paiement récurrent
wayforpay_delete_recurrent() - annule les futurs paiements automatiques du client. Renvoie "Ok" en cas d'exécution réussie.
Vous pouvez également utiliser les blocs "Starting trigger" et "State" (l'exemple utilise les blocs "Non-state with condition" et "Non-state").
Si vous ne voulez pas retirer le client du flux principal du chatbot, utilisez le bloc "Non-state with condition" — ce bloc ne peut pas être saisi manuellement, donc le client restera dans l'entonnoir principal après le paiement tout en recevant une notification de paiement réussi.
Si vous avez besoin de continuer l'entonnoir en fonction du paiement réussi, utilisez le bloc "Starting trigger". Dans ce cas, le client passera du bloc de paiement au bloc "Starting trigger condition", à partir duquel vous pouvez continuer l'entonnoir.