- Comment connecter Paynow
- Comment former un lien de paiement
- Exemple de lien de paiement
- Comment traiter le résultat
Comment connecter Paynow
Saisissez votre compte Paynow. Accédez aux paramètres en cliquant sur l'engrenage.
Ensuite, allez dans Sklepy i punkty płatności
Ci-dessous, dans les paramètres de la ligne de boutique Adres powiadomień, spécifiez l'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)
Accédez à votre projet sur mavibot.pro et dans la section Systèmes de paiement - Paynow, notez les clés trouvées.
Comment former un lien de paiement
Paramètres requis
Avant de spécifier la variable avec le montant du paiement, le client doit avoir une variable email avec son adresse e-mail.
Un exemple de la façon dont vous pouvez demander et enregistrer votre adresse e-mail ci-dessous.
email - e-mail de l'acheteur (si non spécifié, utiliser un faux)
payment_description - la description du paiement s'affiche dans l'interface web (Attention ! Les caractères cyrilliques seront automatiquement remplacés par l'alphabet latin, pas plus de 255 caractères). 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 variable payment_sum (par exemple 150 ou 100.55 (avec un point !)), immédiatement après, la variable paynow_pay_url apparaîtra. Cette variable peut être affichée avec un lien ou placée sur un bouton avec le texte "Payer".
Paramètres optionnels
De plus, avant de définir la valeur payment_sum, vous pouvez spécifier les variables optionnelles suivantes pour configurer le paiement.
first_name - prénom de l'acheteur
last_name - nom de l'acheteur
language - la langue de la page de paiement au format BCP47/RFC5646 (par exemple 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'email
- Ensuite les paramètres optionnels first_name, payment_description, etc.
- Et enfin, attribuez la valeur de la variable payment_sum
Exemple de lien de paiement
Tout d'abord, nous allons demander et enregistrer l'email du client. Nous allons créer un bloc avec la demande de saisir l'email et enregistrer la saisie dans la flèche :
Dans le bloc suivant, le message ne sera pas affiché, nous allons spécifier une description du paiement et immédiatement après, définir la variable avec un montant de paiement de 10 zl (zloty par défaut)
Ensuite, à l'endroit approprié, imprimez la variable paynow_pay_url qui contient le lien. Dans l'exemple, il s'agit du bloc suivant.
Comment traiter le résultat
Après un paiement réussi, le bot recevra des callbacks, grâce auxquels vous pourrez comprendre qu'un paiement a été effectué avec succès.
Ces callbacks dans le système apparaissent comme des messages de l'utilisateur, afin qu'ils ne puissent pas être envoyés par l'utilisateur, ils sont composés des 10 premiers caractères de la clé secrète et du compte succès, par exemple : omc79l97u4_success
Ces callbacks NE SONT PAS VISIBLES par 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 paynow_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 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 la variable 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.
La notification de paiement compare la valeur de la variable paynow_payment_id avec l'identifiant de paiement de 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 un lien de paiement si le précédent n'a pas été complété ou annulé !