Comment configurer PayPal
Pour travailler avec PayPal, vous devez obtenir deux clés : client_id et secret
Accédez à la page https://developer.paypal.com/developer/applications/
Et choisissez dans la liste ou créez une nouvelle application :
En haut, basculez en mode Live et sélectionnez l'application souhaitée. Une page de paramètres s'ouvre où vous pouvez trouver les données recherchées :
Copiez les données et collez-les dans les champs correspondants des paramètres Mavibot - Systèmes de paiement - PayPal :
C'est la fin de la connexion.
Comment créer un lien de paiement
Pour générer un lien de paiement, vous devez définir la valeur de la variable payment_sum et la variable paypal_pay_url apparaît immédiatement.
payment_title n'est pas une variable obligatoire, c'est le nom du produit. Si vous ne la spécifiez pas, elle est remplie avec le texte : "Payment account order_id" (order_id - identifiant de commande sur le serveur)
payment_description - description du produit, facultative
De plus, avant de spécifier payment_sum, vous pouvez indiquer dans quelle langue la page de paiement sera affichée. Pour ce faire, vous devez définir la variable locale, par défaut c'est le russe (ru-RU). Toutes les options possibles : da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW.
Et le troisième paramètre supplémentaire est company_name - le nom de votre entreprise, affiché tout en haut de la page (exemple ci-dessous, entreprise).
Vous pouvez également spécifier la devise dans laquelle le paiement est accepté, pour cela nous spécifions la variable currency, par défaut le rouble (RUB) est défini, pour le dollar définissez sa valeur USD (currency = USD). Les variantes de devises possibles se trouvent sous le lien https://developer.paypal.com/docs/api/reference/currency-codes/
Et le troisième paramètre supplémentaire est company_name - le nom de votre entreprise, affiché tout en haut de la page (exemple ci-dessous, entreprise )
La variable paypal_pay_url peut être affichée avec un lien ou placée sur le bouton "Payer".
Le lien a la forme : https://ww.paypal.com/checkoutnow?token=07N53571YM296381N
Exemple d'implémentation.
Définissez le montant du paiement 444 et le nom de l'entreprise
Remarque : la variable payment_sum est définie en dernier, après les variables facultatives payment_title, company_name, etc.
Comment traiter le résultat
Après un paiement réussi, des callbacks arriveront dans le bot, grâce auxquels vous pouvez comprendre qu'un paiement a été effectué avec succès. Ces callbacks dans le système sont visibles comme des messages de l'utilisateur, ils ne peuvent donc pas être envoyés par l'utilisateur, ils se composent des 10 premiers symboles secrets et d'une page d'accueil avec le statut, par exemple : EHsWHYOoWV_success.
De plus, après un paiement réussi, la variable paypal_payment_completed est définie sur True.
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"
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.
Les callbacks arrivent avec un délai, donc après avoir envoyé le lien de paiement à l'utilisateur, nous recommandons d'envoyer un message du type : "Après le paiement, attendez le message de confirmation de paiement réussi"
Par exemple, vous pouvez créer un bloc de traitement de paiement réussi avec une condition et afficher le message correspondant à l'utilisateur :
Le type de comparaison doit être "Correspondance exacte"
À la fin du paiement, la variable paypal_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.