# Wallet pay

## Connexion du système de paiement ### Connexion côté Telegram **Étape 1.** Connectez-vous à votre compte partenaire {% hint style="info" %} [Pour cela, suivez le lien](https://pay.wallet.tg/) {% endhint %} 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.** {% hint style="success" %} Il est recommandé d’utiliser un compte auquel la personne responsable des finances a accès. Pour les personnes morales – un représentant autorisé. {% endhint %} **Étape 2.** Répondez à un court questionnaire

Fig. 1. Renseignement des informations sur le commerçant

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. {% hint style="warning" %} Pour les personnes morales, le formulaire ne peut être rempli que par une personne de confiance : un directeur ou un employé mandaté. {% endhint %} **É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 : 1. Nommé selon l’une de deux façons : * :purse: Wallet Pay * :purse: Payer via Wallet 2. Placée au-dessus des autres boutons (si vous en avez). > Remarque. :purse: — est un emoji (voir ). > > Voir l’exemple dans \[[Bot de démo du magasin](https://t.me/PineAppleDemoWPStoreBot)]. ## Connexion à Mavibot Connectez-vous au projet et cliquez sur le **« Connecter »** bouton pour Wallet Pay dans la section « Systèmes de paiement ».

Fig. 2. La section « Acquiring » pour connecter le service à Mavibot

Dans la fenêtre qui s’ouvre, saisissez la clé API générée pour votre boutique WalletPay.

Fig. 3. Un formulaire avec un champ de saisie de la clé API

* [x] C’est prêt ! Désormais, les clients peuvent payer leurs achats dans votre boutique en cryptomonnaies (USDT, Toncoin et Bitcoin) à l’aide du service Paypal Wallet. ### 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 : | Paramètres | Description des paramètres | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | **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. |

Fig. 4. Exemple de transmission des paramètres

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.** {% hint style="warning" %} Ce lien ne peut être ouvert que dans une conversation avec un bot connecté à un compte de facturation WalletPay. {% endhint %} ### 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) : - 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) :

Fig. 5. Un exemple de réaction à un callback dans le bloc « Condition de départ »

Fig. 6. Un exemple de réponse à un callback dans le bloc « Condition non étatique »

{% hint style="info" %} 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. {% endhint %} {% hint style="info" %} De plus amples informations sur les blocs conditionnels sont fournies dans l’article du même nom. lien[nous avons parlé des blocs avec condition](broken://pages/39246a461682c678f82fab4ff666ba0a082e593a) {% endhint %} ### Liens utiles \[[Assistance professionnelle Wallet Pay](https://t.me/WalletPay_supportbot)] \[[Bot de démo du magasin](https://t.me/PineAppleDemoWPStoreBot)] \[[Communauté des marchands](https://t.me/+6TReWBEyZxI5Njli)] --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/fr/paiement/wallet-pay.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.