Hi! This article is aimed at developers who already possess working knowledge of , and want to implement a monetization option. I will outline the basic steps which must be undertaken to get your bot to start accepting payments using the official Bot payment API and provider. Telegram-Powered Bots Paymentwall This article does not go into technical detail and discuss any code necessary for implementation, but it can give you a basic general understanding of the integration process. What is Bot Payments API? Last year, Telegram released an important which facilitated the creation of bots to generate invoice message and show native payment dialogue. However, this feature is currently only supported on mobile devices and is not compatible with the desktop and web version. As Telegram official says: update documentation Telegram bots can accept payments for goods and services from users as of . Users will need or higher to pay for your goods and services. Bot API v.3.0 Telegram v.4.0 Using Telegram Web, the user will not be able to get even invoice message. Attempting to open a payment dialogue with the desktop or web version will result in the following error message: However, don’t fret as almost all payment processors offer you the opportunity to generate a payment widget which can be integrated in your bot and opened using a browser. You will need to add all the relevant product details. You will need to specify your product details, like price, name, currency, etc to get the link. All payment processors will provide technical documentation about implementation: So now you have two possibilities for using your bot: In-app payment (Bot Payments API) Using web payment widget (Payment provider API should support this) I decided to implement both in my bot game, see the screenshot below: In-app and web payments Using Telegram Bot API you , which means that you will be unable to specify the necessary currency for invoicing. There are no chance to track user location even through analytics tools like Yandex AppMetrica or Google Analytics (you will track as a location for every user). But you still can give your user a UI to select currency. won’t be able to get user location Botswana Also, there is from your bot message data**.** So you can’t switch payment options on the fly based on user platform. no chance to get user client platform Summing up: Only credit card payments Available for Telegram mobile apps only Users will pay inside the application 💳 Payment provider Telegram does not process payments from users and instead relies on 3rd party . They are the ones that will handle and store all the sensitive information such as card details, name and address. Neither Telegram nor the bot developers have access to it. payment processors So, Telegram acts like a middleware between user and payment provider, and it also doesn’t charge any commission for this option. At the moment Telegram Bot Payments API is integrated with several payment processors: Stripe Paymentwall Yandex.Money Sberbank Payme CLICK Rave by Flutterwave Tranzzo I was looking for payment provider which will support processing for users from CIS region and came across as the best option for myself. It’s API provides support for generating payment widget for the browser as well as processing credit cards payments through Bot Payments API, furthermore, it supports a far larger number of countries in comparison to the providers mentioned in the list above. Paymentwall 🇺🇸 🇨🇦 🇩🇿 🇦🇸 🇦🇩 🇦🇷 🇦🇲 🇸🇭 🇦🇺 🇦🇹 🇦🇿 🇧🇸 🇧🇭 🇧🇩 🇧🇧 🇧🇪 🇧🇿 🇧🇲 🇧🇷 🇧🇳 🇧🇬 🇰🇭 🇰🇾 🇨🇱 🇨🇳 🇨🇰 🇨🇷 🇭🇷 🇨🇾 🇨🇿 🇩🇰 🇩🇲 🇩🇴 🇪🇨 🇪🇬 🇸🇻 🇪🇪 🇫🇰 🇫🇴 🇫🇯 🇫🇮 🇫🇷 🇬🇫 🇵🇫 🇬🇪 🇩🇪 🇬🇮 🇬🇷 🇬🇱 🇬🇩 🇬🇵 🇬🇺 🇬🇹 🇬🇾 🇭🇳 🇭🇰 🇭🇺 🇮🇸 🇮🇳 🇮🇩 🇮🇪 🇮🇲 🇮🇱 🇮🇹 🇯🇲 🇯🇵 🇯🇴 🇰🇿 🇰🇷 🇰🇼 🇰🇬 🇱🇻 🇱🇮 🇱🇹 🇱🇺 🇲🇴 🇲🇰 🇲🇾 🇲🇻 🇲🇹 🇲🇭 🇲🇶 🇲🇺 🇲🇽 🇲🇩 🇲🇨 🇲🇪 🇲🇦 🇳🇵 🇳🇱 🇳🇨 🇳🇿 🇳🇮 🇳🇺 🇳🇫 🇲🇵 🇳🇴 🇴🇲 🇵🇼 🇵🇦 🇵🇾 🇵🇪 🇵🇭 🇵🇳 🇵🇱 🇵🇹 🇵🇷 🇶🇦 🇷🇪 🇷🇴 🇷🇺 🇻🇨 🇸🇲 🇸🇦 🇷🇸 🇸🇨 🇸🇬 🇸🇰 🇸🇮 🇿🇦 🇬🇸 🇪🇸 🇱🇰 🇰🇳 🇱🇨 🇵🇲 🇸🇷 🇸🇪 🇨🇭 🇹🇼 🇹🇭 🇹🇰 🇹🇴 🇹🇹 🇹🇷 🇹🇲 🇹🇨 🇹🇻 🇺🇦 🇦🇪 🇬🇧 🇺🇾 🇻🇳 🇻🇬 🇻🇮 🇼🇫 🇼🇸 🇦🇼 I haven’t made a comparison between rates and the commission surcharge for each and every, so it’s entirely possible that other providers might be cheaper than Paymentwall. You can carry out some independent research and pick the one that will fit your bill. The main requirement is that your provider’s API should have an option to generate payment widget for the browser as well as support Bot Payments API. Please note, that every provider will verify you as a merchant, and you should be ready to send them all of required documents when requested. Products you want to sell, and your bot will be verified based on provider rules and restrictions. They will verify you in order to make sure that you are selling authentic products. For example, here is the list of prohibited areas that Paymentwall will not be able to work with. In my case, I was planning to sell an in-game virtual currency, so it was a typical case for verification process. My verification took , but that’s because I wasn’t able to prepare all documents in time, so it could be faster. I was receiving full support about needed documents and technical integration during set up. approximately 2 weeks Summing up: Your provider should support Bot Payments API as well as payment widget generation for the browser. It should have convenient rates and commissions that will fit your expectations. Should support your target countries, and credit cards processing in that countries. 📃 Terms and conditions You must have clear document with Users should accept it before actual payment or before registration. You also must provide and be able to handle refund or other payments related requests from your bot users, they shouldn’t go to payment provider or Telegram support. terms and conditions the refund policy. customer support There are no strict rules about writing terms and conditions, but the main point that you should specify in which period your user can request a refund after the payment was done. — Product return, a process in which a consumer returns a product to the original retailer in exchange for money previously paid. Money back guarantee — a guarantee that, if a buyer is not satisfied with a product or service, a will be made. Refund refund Here are the from my bot game. Feel free to use it as an example for your bot. I’m showing it in the payments step because I don’t want to block the user with it during registration. Terms and Conditions Payment step message from bot Summing up: You need terms and conditions with the refund policy Users should accept your terms and conditions before payment You need to provide customer support for your users, every user should easily find support link. 📝 Registration and integration I’m using for my bot game, so next words will be about integration with this payment provider. Paymentwall First of all, you need to connect your bot to the payment provider you select. For that you need to go to the , select your bot, click select Paymentwall from the list and click (you will be able to after test integration) BotFather Payments, Connect Paymentwall Test Connect Paymentwall Live After the click, you will be redirected to the provider’s authorization bot. Here you just click like in regular Telegram Bot, and then you will see next message: Start, Paymentwall authorization bot The link from button leads to Paymentwall step, where you will be asked for approval to authorize your account if you have one. OAuth Paymentwall oAuth step But probably you don’t, so after redirect you will see account registration form. Proceed with it and then you will be redirected to that step. After authorization, you should be redirected back to the Paymentwall Bot where you will get a message that your account was successfully authorized in the system. Authorization complete BotFather will show you for Bot Payments API, you will use it for sending invoice messages. Telegram has an and about how to implement invoice messages logic in your bot. test token article API docs During test integration, you will need to make test payments. You can use test credit cards and codes from Paymentwall to emulate different responses. sandbox In your Paymentwall dashboard you will see section where all your projects are listed. After registration there will be two tests projects, one for bot payments, it’s name will start from numbers and contain label. The second project is created by default, you will be able to use it for displaying payment widget in the browser. You can read more about payment widget integration in . My Projects Test API docs Note, that payment web widget provides , which depend on user country and your project settings, while Bot Payment API supports several payment options credit cards only. Now you can start to fill in business profile and upload required documents ( . Documents list is based on your country of registration and business type (individual or company) and you will see it on the last step of the business profile form. If you will have any issues, feel free to contact the support team, they should consult you during merchant validation process. Go to Account -> Business Profile) Summing up: Authorize through BotFather and connect Test project. Implement send invoice mechanism in your bot. Complete your business profile and upload required documents. Docs: Bot Payments API integration Paymentwall Widget API Test credit cards 🚀 Going live Once your merchant account will be approved and test integration will be done, you can go to the @BotFather and You will go through the same process as connecting test. New project with label in the name, will be created in your projects list. BotFather will show you a for bot payments. Connect Paymentwall Live. Live live token Now you can submit your for review by Paymentwall integration team. On this step, they will verify how legal is your product and whether it satisfies all requirements. They will be checking your user policies, so you should prepare this documents before this step. live projects They will also check how technical integration was made and does your application correctly handles service from Paymentwall. pingbacks And once project review process is done, you are ready to start accepting payments from mobile, web and desktop Telegram users 🎉 Your telegram mobile and Paymentwall Web widget (on the yellow background) P.S. If you want to see a live demo, check my bot game by this . You will need to register your character and the go to the 🏘 🏦 💎 to be able to check payments flow. link Town — Bank — Buy diamonds Thank you for reading! Cheers! 🍻
