Wayforpay
Inscription rapide et confirmation du commerçant
Inscription du commerçant pour les particuliers sans site web
Pourcentage unifié pour les particuliers et les personnes morales – 2,5 %
Disponibilité de Google Play et Apple Pay
Comment connecter
Pour connecter le système de paiement wayforpay, vous aurez besoin de 3 valeurs :
identifiant du commerçant
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 « Acquisition », 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 payment_sum variable (par exemple, 150 ou 100,55 ; si le montant est fractionnaire, il est alors séparé par un point) :
Juste après cela, la wayforpay_pay_url variable 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 se trouve 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éfinie ; si vous avez besoin d'une autre devise, vous devez définir la valeur de la variable de devise.
Aussi, avant de définir la valeur de la payment_sum variable, vous pouvez définir les variables facultatives suivantes pour configurer le paiement.
currency - est la devise par défaut de la commande, UAH (valeurs possibles : USD, EUR, RUB)
session_timeout - durée de vie du lien en secondes, la valeur par défaut est 3600 (1 heure)
product_name - nom du produit
language - langue de la page de paiement, la valeur par défaut est UA (valeurs possibles : RU, EN) buyer_name - nom du client
buyer_email - e-mail du client
buyer_first_name - nom du client
buyer_last_name - nom de famille du client
Voici à quoi ressemble un lien vers la page de paiement.
Créons un lien de paiement pour un montant de 1 USD et une durée de validité de 2 heures :
Attention : - Tout d'abord, indiquez les paramètres facultatifs product_name etc. pour les adresses - Et enfin, attribuez la valeur de la payment_sum variable.
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 wayforpay_pay_url variable, 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 rappels seront envoyés au bot, ce qui vous permettra de savoir que le paiement a réussi. Vous voyez ces rappels dans le système sous forme de messages de l'utilisateur ; afin que l'utilisateur ne puisse pas les envoyer, ils se composent des 10 premiers caractères de la clé secrète et du suffixe _success, par exemple : flk3409ref_success
Ces rappels 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 sortir le client du schéma principal du chatbot, utilisez le bloc « Sans état avec condition ». Vous ne pouvez pas accéder à ce bloc, donc le client ne sera pas retiré de l'entonnoir principal après le paiement et recevra une notification de paiement réussi.
Et si vous devez poursuivre l’entonnoir avec une réaction à un paiement réussi, utilisez alors le bloc « Condition de départ », puis le client passera du bloc de paiement au bloc « Condition de départ », à partir duquel vous pourrez poursuivre l’entonnoir.
Plus d'informations sur les blocs conditionnels sont fournies dans l'article du même nom
Une fois le paiement effectué, la variable wayforpay_callback_data variable sera ajoutée au client et contiendra les données de la réponse du système de paiement pour la transaction effectuée. Vous pouvez extraire les données nécessaires du dictionnaire obtenu à l’aide de la 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.
amount
montant du paiement
currency
devise. Par défaut : UAH (valeurs possibles : USD, EUR, RUB). Paramètre facultatif.
session_timeout
durée de vie du lien en secondes. Par défaut : 3600 (1 heure). Paramètre facultatif.
product_name
nom du produit. Paramètre facultatif.
language
langue de la page de paiement. Par défaut : UA (valeurs possibles : RU, EN). Paramètre facultatif.
buyer_name
nom du client. Nom facultatif.
buyer_email
E-mail du client. Paramètre facultatif.
regular_date_next
date de la prochaine transaction automatisée. Par défaut : un mois après la création du lien. Paramètre facultatif.
regular_date_end
date de fin de la transaction automatisée. Par défaut : un an après la création du lien. Peut être omise si le paramètre regular_count est spécifié. Paramètre facultatif.
regular_count
nombre de transactions automatisées. Si spécifié, le paramètre regular_date_end sera ignoré. Paramètre facultatif.
regular_mode
intervalle de paiement récurrent. Paramètre facultatif. Valeurs possibles : - once - paiement unique - daily - quotidien - weekly - hebdomadaire - quarterly - tous les 3 mois après la date du premier paiement - monthly - mensuel - bimonthly - une fois tous les 2 mois - halfyearly - une fois tous les 6 mois - yearly - une fois par an
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 « Déclencheur de démarrage » et « État » (l'exemple utilise les blocs « Sans état avec condition » et « Sans état »).
Si vous ne souhaitez pas retirer le client du flux principal du chatbot, utilisez le bloc « Sans état avec 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 devez poursuivre l'entonnoir en fonction du paiement réussi, utilisez le bloc « Déclencheur de démarrage ». Dans ce cas, le client passera du bloc de paiement au bloc « Condition du déclencheur de démarrage », à partir duquel vous pourrez continuer l'entonnoir.
Mis à jour