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 l'autorisation - cliquez sur "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 petit questionnaire
Si vous vous connectez pour la première fois ou si des informations supplémentaires sont nécessaires, WalletPay vous propose de répondre à quelques questions pour 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 sous peu et vous serez informé des résultats. En cas de succès, vous verrez la commission facturée par le service et aurez 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é par procuration.
Étape 3. Créez la première "Boutique".
Après avoir réussi le "Questionnaire", il vous sera proposé de créer votre première boutique.
Étape 4. Créez 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. Retirez les fonds
Une fois que le client confirme le paiement, les fonds sont crédités sur vos actifs et sont conservés pendant 48 heures par défaut. Passé 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. Remboursement des fonds
Actuellement, le retrait des fonds est disponible depuis votre compte Wallet, que vous utilisez pour vous connecter à WalletPay. Mais cela 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é de l'une des deux manières suivantes :
- 👛 Wallet Pay
- 👛 Payer via Wallet
- Situé au-dessus des autres boutons (si vous en avez).
Remarque. 👛 — c'est un emoji (voir https://emojipedia.org/purse/).
Voir l'exemple dans [Demo Store Bot].
Connexion à Mavibot
Connectez-vous au projet et cliquez sur le bouton "Connecter" 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.
- Prêt ! Désormais, les clients peuvent payer leurs achats dans votre boutique en cryptomonnaies (USDT, Toncoin et Bitcoin) via le service Paypal Wallet.
Comment générer un lien de paiement
Créez un bloc constructeur d'entonnoir et appelez la fonction "wallet_pay_generate_payment_url" dans le calculateur, en lui passant les paramètres nécessaires :
| Paramètres | Description des paramètres |
|---|---|
| amount | le montant du paiement en cryptomonnaie ou autre monnaie fiduciaire disponible pour conversion en "TON". |
| сurrency_code | La devise de paiement par défaut est "RUB". Liste des devises disponibles : "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
| description | une brève description de la commande de 5 à 100 caractères. |
| timeout_seconds | La durée de validité du lien en secondes, par défaut 3600 secondes. |
Lorsque le bloc est déclenché dans un chat avec un bot, le client recevra un lien de paiement, et la variable client wallet_pay_payment_completed sera créée avec la valeur False.
Ce lien ne peut être ouvert que dans un chat avec un bot connecté à un compte de facturation WalletPay.
Vérification du paiement
Après un paiement réussi, la variable wallet_pay_payment_completed du client passera à True, et le vendeur recevra un callback sous la forme 4690FE98_success, qui se compose de :
- "4690FE98" - ce sont les 8 premiers caractères de la clé API Wallet Pay.
- du mot succès
! en cas d'erreur de paiement, 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 voulez pas faire sortir le client du schéma principal du chatbot, utilisez le bloc "Condition non étatique". Vous ne pouvez pas aller vers ce bloc, donc le client ne sera pas sorti de l'entonnoir principal après le paiement et recevra une notification de paiement réussi.\
Et si vous devez continuer l'entonnoir avec une réaction à un paiement réussi, utilisez le bloc "Condition de départ", alors le client passera du bloc de paiement au bloc "Condition de départ", à partir duquel vous pourrez continuer l'entonnoir.
Plus d'informations sur les blocs conditionnels sont fournies dans l'article du même nom. blocs avec condition expliqués