Wallet Pay
Connexion du système de paiement
Connexion côté Telegram
Étape 1. Connectez-vous à votre compte partenaire
Sur la page qui s’ouvre, cliquez sur « Se connecter via Telegram », puis saisissez votre numéro de téléphone dans la fenêtre contextuelle « Apparaît oauth.telegram.org » et cliquez sur « Appliquer ».
Il est nécessaire de connecter le système de paiement à la fois via le navigateur web et via l’application :
Vous recevrez un message Telegram demandant une autorisation — cliquez « Appliquer ».
Vous devez également cliquer sur « Appliquer » dans la fenêtre contextuelle « oauth.telegram.org » dans un navigateur web.
Il est recommandé d’utiliser un compte auquel la personne responsable des finances a accès. Pour les personnes morales – un représentant autorisé.
Étape 2. Répondez à un court questionnaire
Si vous vous connectez pour la première fois ou si vous avez besoin d’informations supplémentaires, WalletPay vous propose de répondre à quelques questions afin d’obtenir des informations plus détaillées. Il y a deux étapes :
1. Questionnaire
2. Vérifications KYB (Know Your Business) ou KYC (Know Your Customer)
Une fois terminé, votre demande sera examinée prochainement et vous serez informé des résultats. En cas de succès, vous verrez la commission facturée par le service et obtiendrez l’accès à votre compte, où vous pourrez commencer l’intégration.
Pour les personnes morales, le formulaire ne peut être rempli que par une personne de confiance : un directeur ou un employé mandaté.
Étape 3. Créez le premier « Store ».
Après avoir réussi le « Questionnaire », il vous sera proposé de créer votre première boutique.
Étape 4. Créer une « clé API »
Après le nom de la première boutique, il vous sera proposé de la configurer :
Générez une clé API.
Copiez votre clé API et commencez l’intégration avec Mavibot.
Étape 5. Créez une commande et recevez un lien de paiement
Si vous souhaitez placer un lien dans un bouton, utilisez Inline Button.
Veuillez noter que seul le « customerTelegramUserId » spécifié peut ouvrir la page de paiement.
Étape 6. Retirer les fonds
Après confirmation du paiement par le client, les fonds sont crédités sur vos actifs et sont conservés pendant 48 heures par défaut. Après ce délai, vous pourrez retirer les fonds vers le solde de votre Wallet, que vous avez utilisé pour vous connecter au service Paypal Wallet.
Étape 7. Retour des fonds
Actuellement, le retrait des fonds est disponible depuis votre compte Wallet, que vous utilisez pour vous connecter à WalletPay. Mais il sera bientôt disponible dans votre compte marchand.
À quoi ressemble le bouton de paiement ?
Lors de l’intégration de votre bot Telegram avec l’« API Wallet Pay », assurez-vous que le bouton de paiement respecte les recommandations suivantes :
Nommé selon l’une de deux façons :
:purse: Wallet Pay
:purse: Payer via Wallet
Placée au-dessus des autres boutons (si vous en avez).
Remarque. :purse: — est un emoji (voir https://emojipedia.org/purse/).
Voir l’exemple dans [Bot de démo du magasin].
Connexion à Mavibot
Connectez-vous au projet et cliquez sur le « Connecter » bouton pour Wallet Pay dans la section « Systèmes de paiement ».
Dans la fenêtre qui s’ouvre, saisissez la clé API générée pour votre boutique WalletPay.
Comment générer un lien de paiement
Créez un bloc du constructeur d’entonnoir et appelez la « wallet_pay_generate_payment_url » fonction dans la calculatrice, en lui transmettant les paramètres nécessaires :
amount
le montant du paiement en cryptomonnaie ou dans une autre monnaie fiduciaire disponible pour la conversion en « TON ».
currency_code
La devise de paiement par défaut est « RUB ». Liste des devises disponibles : « TON » « BTC » « USDT » « EUR » « USD » « RUB »
description
une courte description de la commande de 5 à 100 caractères.
timeout_seconds
La durée de validité du lien est en secondes, la valeur par défaut est de 3600 secondes.
Lorsque le bloc est déclenché dans une conversation avec un bot, le client recevra un lien de paiement, et le wallet_pay_payment_completed variable client sera créée avec la valeur False.
Ce lien ne peut être ouvert que dans une conversation avec un bot connecté à un compte de facturation WalletPay.
Vérification du paiement
Après un paiement réussi, la wallet_pay_payment_completed variable du client sera définie sur True, et le vendeur recevra un callback sous la forme de 4690FE98_success, qui se compose de :
« 4690FE98 » — ce sont les 8 premiers caractères de la clé API Wallet Pay.
mots sur le succès
! si une erreur de paiement survient, vous recevrez un callback avec le suffixe «_fail».
Adresse pour les notifications (callbacks) : https://chatter.salebot.pro/wallet_pay/payment_callback - insérée dans les paramètres du système de paiement
Un callback peut être intégré dans la condition du bloc pour envoyer un message au client concernant un paiement réussi (ou une erreur de paiement) :
Si vous ne souhaitez pas sortir le client du schéma principal du chatbot, utilisez le bloc « Condition non étatique ». Vous ne pouvez pas aller à ce bloc, de sorte que le client ne sera pas sorti de l’entonnoir principal après le paiement et recevra une notification de paiement réussi. 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.
De plus amples informations sur les blocs conditionnels sont fournies dans l’article du même nom. liennous avons parlé des blocs avec condition
Liens utiles
Mis à jour