Stripe
Comment connecter
Pour connecter le système de paiement Stripe, vous avez besoin d’une clé API secrète et d’une clé de webhook.
Vous pouvez copier la clé API secrète dans la section Developers -> API key et copier la Secret key.
Ensuite, vous devez définir l’URL pour les Callbacks. C’est nécessaire pour que le bot reçoive les notifications de paiement.
Allez dans la section Webhooks et ajoutez une adresse pour les webhooks.
définissez l’URL : https://chatter.salebot.pro/stripe_callback/result
et sélectionnez l’événement :
checkout.session.completed
Enregistrez et accédez à la page avec le webhook installé, copiez la clé (Signing secret) du webhook (dans le champ salebot - Webhook key) :
après avoir appuyé sur Reveal key, le Webhook s’ouvrira, qui commencera par whsec_...
Après avoir reçu les clés, nous passerons aux paramètres dans Salebot.
Dans Salebot, ouvrez la section des systèmes de paiement, sélectionnez Stripe. Sur la page de connexion, vous devez saisir les données reçues.
Comment obtenir un lien de paiement
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 !)), puis la variable stripe_pay_url apparaît. Cette variable peut être affichée sous forme de lien ou placée sur le bouton avec le texte « Payer ».
Le lien a la forme :
https://checkout.stripe.com/pay/cs_test_a17mskKFFRwEuo3WgBSAUjfk7xaZZIrct9B3Ds2AdODVq1I8aRiqYEBdrU#fidkdWxOYHwnPyd1blpxYHZxWjA0TGFsVzFPVmpmMzJAbVYzUkp1Y0lLYDVgfzR2Q0NxcWZBNUNnTnRSVVRJSGFobEB1UExSczRMMTc8PWRLMGBddl8xalxyPDRoUGhnZm9xXXZANDZyaF0wNTVBVExsPHZyfycpJ2N3amhWYHdzYHcnP3F3cGApJ2lkfGpwcVF8dWAnPyd2bGtiaWBabHFgaCcpJ2BrZGdpYFVpZGZgbWppYWB3dic%2FcXdwYHgl
L’ensemble par défaut est USD (dollar) ; 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 payment_sum, vous pouvez spécifier les variables optionnelles suivantes pour configurer le paiement.
currency - devise de la commande. Valeurs valides - https://stripe.com/docs/currencies
payment_description - description de la commande
Exemple de lien de paiement
Créer un lien pour un paiement de 2 EUR (dollar par défaut)
Veuillez noter :
Spécifiez d’abord les paramètres optionnels first_name, payment_description, etc.
Et enfin, attribuez la valeur de la variable payment_sum
Remarque : nous définissons d’abord les variables supplémentaires pour les paramètres, puis payment_sum. Vous pouvez définir des variables plus tôt dans une chaîne, et non dans un seul bloc ; c’est un exemple.
Ensuite, au bon endroit, nous afficherons la variable stripe_pay_url, qui contient le lien dans le bloc ou dans le bouton
Page d’exemple de paiement
Comment traiter le résultat
Après un paiement réussi, des callbacks arriveront dans le bot, grâce auxquels vous pourrez comprendre qu’un paiement a été effectué avec succès. Dans le système, ces callbacks apparaissent comme des messages de l’utilisateur, de sorte qu’ils ne peuvent pas être envoyés par l’utilisateur ; ils se composent des 20 premiers caractères de la clé secrète et du mot success, par exemple : sk_live_d35gky6d8ers_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 »
De plus, après un paiement réussi, la variable stripe_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 :
Une fois le paiement terminé, une variable stripe_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.
Comment tester les paiements
Vous pouvez utiliser la clé secrète de l’environnement de test pour tester l’intégration. Pour ce faire, dans le menu stripe du compte personnel, à droite, vous devez passer à l’environnement de test.
Ensuite, configurez la configuration décrite au début de cette instruction. Entrez la clé secrète de test et ajoutez l’adresse pour les webhooks à l’environnement de test.
Numéro de carte de test
4242 4242 4242 4242
n’importe quelle date future
CVC - n’importe quels trois chiffres
Si quelque chose ne fonctionne pas, comparez les données avec celles du site officiel : https:/stripe.com/docs/testing#regulatory-cards
Mis à jour