Paynow
Système de paiement polonais
Comment connecter Paynow
Entrez dans votre compte paynow. Accédez aux paramètres en cliquant sur la roue dentée.
Ensuite, nous allons dans Sklepy i punkty płatności
Ci-dessous, dans les paramètres de la ligne de boutique Adres powiadomień - nous spécifions l'adresse URL pour recevoir le callback de paiement :
https://chatter.salebot.pro/paynow_callback/result
Ci-dessous, vous devez copier la clé API (Klucz dostępu do API) et la clé secrète (Klucz obliczania podpisu)
Allez sur votre projet sur salebot.pro et dans la section Systèmes de paiement - Paynow notez les clés trouvées.
Comment créer un lien de paiement
Paramètres requis
Avant de spécifier la variable avec le montant du paiement, le client doit disposer d'une variable e-mail avec son adresse e-mail
Un exemple de la manière dont vous pouvez demander et enregistrer votre adresse e-mail est présenté ci-dessous.
e-mail - e-mail de l'acheteur (si non spécifié, faux)
payment_description - la description du paiement est affichée dans l'interface web (Attention ! Le cyrillique sera automatiquement remplacé par l'alphabet latin, 255 caractères maximum). Si non spécifié, remplir automatiquement : Paiement de la facture numéro "ici numéro"
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 (avec un point !)), juste après cela la paynow_pay_url variable apparaîtra. Cette variable peut être affichée avec un lien ou placée sur le bouton avec le texte "Payer".
Le lien a la forme : https://paywall.paynow.pl/NOH0-0LT-SEY-XOI?token=eyJraWQiOiJhMDAyNjJjYS02NTU3LTRjOTktOGU0NC1kMTFlMTAxYjhhNTIiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJOT0gwLTBMVC1TRVktWE9JIiwiYXVkIjoicGF5d2FsbC5zYW5kYm94LnBheW5vdy5wbCIsImlzcyI6InNhbmRib3gucGF5bm93LnBsIiwiZXhwIjoxNjE5NTkyOTc4LCJpYXQiOjE2MTk1MDY1Nzh9.dnCfjADHiTynvXk41TVxsQEVfDAnHFDC_9sdzWF4G2s
Paramètres facultatifs
Aussi, avant de définir la payment_sum valeur, vous pouvez spécifier les variables optionnelles suivantes pour configurer le paiement.
prénom - nom de l'acheteur
nom - nom de l'acheteur
language - la langue de la page de paiement au format BCP47/RFC5646 (par ex. pl-PL, en-US)currency - code de devise du paiement ISO 4217. Si non spécifié, la valeur par défaut (PLN) est utilisée.
Veuillez noter :
Spécifiez d'abord l'e-mail
Paramètres optionnels suivants first_name, payment_description, etc.
Et enfin, attribuez la valeur de la payment_sum variable
Exemple de lien de paiement
Tout d'abord, nous allons interroger et enregistrer l'e-mail du client. Nous créerons un bloc avec la demande de saisie de l'e-mail et enregistrerons la saisie dans la flèche :
Dans le bloc suivant, le message ne sera pas affiché, nous spécifierons une description du paiement et après cela, nous définirons immédiatement la variable avec un montant de paiement de 10 zl (zloty par défaut)
Ensuite, au bon endroit, affichez la variable paynow_pay_url qui contient le lien. Dans l'exemple, c'est le bloc suivant.
Comment traiter le résultat
Après un paiement réussi dans le bot, des kolbeks arriveront, grâce auxquels vous pourrez comprendre qu'il y a eu un paiement réussi.
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 10 premiers caractères de la clé secrète et du succès du compte, par exemple : omc79l97u4_success
Ces callbacks NE SONT PAS visibles pour l’utilisateur, ils ne s’affichent que pour l’opérateur.
Le type de comparaison doit être « Correspondance exacte »
Aussi, après un paiement réussi, la variable paynow_payment_completed est définie sur True.
Par exemple, vous pouvez créer un bloc de traitement d'un paiement réussi avec une condition et afficher le message correspondant à l'utilisateur :
À la fin du paiement, la variable paynow_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 généré précédemment, puis, après avoir réinitialisé la variable payment_sum, obtenir un nouveau lien. Vous pouvez spécifier une valeur précédente.
La notification de paiement compare la valeur de la variable paynow_payment_id avec l'identifiant du paiement figurant dans la notification ; s'ils ne correspondent pas, cela signifie que le paiement a été effectué avec un ancien lien. Dans votre correspondance avec l'utilisateur, vous verrez une notification à ce sujet.
Nous vous recommandons vivement de ne pas recréer le lien de paiement si le précédent n'a pas été terminé ou annulé !
Mis à jour