Accept payments in Telegram
This setup is for services that sell through Telegram: a bot that sends payment links in a chat, or a mini app, a web app that opens inside Telegram. Your customers pay without leaving Telegram, the bot confirms the order in the chat, and the money lands on your Volet.com balance, ready to withdraw or to pay partners.
Is this for you
This setup fits if you:
- Sell a service that is used outside Telegram through a bot: a VPN, hosting, a SaaS product, consulting, lessons, or a booking.
- Sell physical goods through a bot or a mini app.
- Let users top up a balance in your own service from Telegram.
- Pay partners or users from the money your bot collects.
A personal account is enough. You need a business account only if payments must go in a company's name or your volumes outgrow personal limits. See Choose a personal or business account.
Consider something else if:
- You sell digital goods or content that are used inside Telegram itself: paid posts, in-game items, access to a private channel. Telegram requires its own currency, Telegram Stars, for them; see Check what Telegram allows below.
- You run the bot on your own and are just starting. See Launch a paid online service; everything on this page about Telegram applies too.
- You also pay contractors, partners, or users from the same balance. See Let users top up and withdraw for the payout side.
Check what Telegram allows
Telegram requires Telegram Stars for digital goods and services that are sold and used inside a bot or mini app. You cannot sell them for crypto through a payment gateway. See Telegram's payments for digital goods and Bot Developer Terms.
A payment gateway such as Volet.com fits everything else: services used outside Telegram, physical goods, top-ups of a balance in your own service, payouts to partners, and settlements between businesses.
What you can do
Accept payments
- Let customers pay in crypto from any external wallet, such as USDT on Tron or TON, or from their Volet.com balance. Crypto payers do not need a Volet.com account. — Custodial crypto payments, Accept payments via Volet.com users
- Open the Hosted Checkout page inside the mini app: it loads in the app's built-in browser, with your logo and brand colors. — Create payment gateway
- Build your own payment screen in the chat or the mini app with the API, and show customers the address and amount yourself. — API integration
- Give the gateway your bot's address, for example
https://t.me/example_bot: customers see it on the payment page. — Configure settings - Preselect the payment method and the language of the payment page for your audience. — Hosted Checkout advanced configuration
Keep and use the money
- Receive every payment in the currency you choose, whatever the customer paid with; USD, USDT, and USDC convert 1:1. — Settlement and auto-conversion
- Pay partners or users from the same balance, or withdraw to a bank account, a card, or a crypto wallet. — Withdraw or send funds
Who does what
| Needs | Sees and does | Responsible for | |
|---|---|---|---|
| You | A verified Volet.com account, personal or business, an approved payment gateway, a bot created in @BotFather, a backend | Creates the payment request, sends the payment button or opens the payment page, confirms the order in the chat | Compliance with Telegram's rules, your product and its delivery, refunds, customer support in the bot |
| Your customers | Telegram, and a crypto wallet or a Volet.com account | Taps the button in the chat or pays inside the mini app, sees the Volet.com payment page with your bot's address | Paying on the network shown on the page |
| Telegram | — | Hosts your bot and mini app | Its own rules for payments in bots, including Telegram Stars for digital goods |
| Volet.com | — | Hosts the payment page, monitors the blockchain, screens incoming crypto (AML), converts currencies, notifies your backend | Payment processing and support for payment issues. It does not deliver your product or refund your customers |
How the money moves
- The customer chooses a product in your bot or mini app.
- Your backend creates a payment request in Volet.com and stores the Telegram user ID with the order.
- The bot sends a payment button, or the mini app opens the payment page.
- The customer pays in crypto or from their Volet.com balance. For crypto, Volet.com waits for network confirmations and screens the payment.
- The payment is credited to your account in your settlement currency and is available immediately.
- Volet.com sends a notification to your backend; the bot confirms the order in the chat and delivers the product.
Set it up
Step 1: Create a payment gateway
Start with Hosted Checkout: the payment page is hosted by Volet.com, works inside a mini app, and supports both crypto and balance payments. Choose the API if you want the payment screen to be part of your chat or mini app. In the gateway settings, enter your bot's address, enable the digital signature, decide whether to accept underpayment and overpayment, and set the Status URL of your backend. Approval usually takes a few hours. See Create payment gateway and Choose an integration method.
Step 2: Create a bot in Telegram
- Open @BotFather in Telegram and create a bot with the
/newbotcommand. - Save the bot token. Your backend uses it to send messages through the Telegram Bot API.
- To open a web interface inside Telegram, create a mini app in @BotFather and set the URL of your web app. See Telegram Mini Apps.
For a first bot, follow Telegram's bot tutorial.
Step 3: Show the payment page
- In a bot chat: send a message with an inline button that opens your payment URL. See InlineKeyboardButton.
- In a mini app: open the Hosted Checkout page inside the mini app, or open it in the device browser with
Telegram.WebApp.openLink. See Telegram Mini Apps.
Your backend creates the payment request before the page opens, so the bot can match the payment to the order. See Hosted Checkout integration.
Step 4: Confirm the order in the chat
When your backend receives the payment notification and verifies its signature, send the customer a message from the bot and deliver the product. Do not rely on the customer returning to the chat or the mini app.
Step 5: Take the first payment through the bot
Volet.com has no sandbox, so the first payment is a real one: pay a small amount through the bot yourself, from a crypto wallet and from a Volet.com account, and check that the confirmation reaches the chat. A small bot takes about a day to integrate. From then on, every sale lands on your balance; withdraw it, keep it in stablecoins, or use it to pay partners. See Withdraw or send funds.
Self-custody option
In a mini app, customers can also pay straight from their own wallet to yours, through a Volet.com smart contract. This suits bots for crypto-native audiences and projects that must hold funds themselves.
- The mini app connects the customer's wallet. Telegram requires TON Connect for wallet connections inside a mini app.
- The customer confirms the payment in their wallet, in USDT, USDC, or a native token on a supported network, TON included.
- The payment arrives in your wallet; your backend checks the transaction on-chain and the bot confirms the order in the chat.
- To withdraw to fiat or pay partners through Volet.com, send part of the crypto to your Volet.com account. A deposit to a permanent address of your crypto wallet, in the same currency, has no Volet.com fee. See Add funds.
What changes: customers pay only from wallets and pay the network fees; there is no automatic conversion; the setup is configured individually with the sales team, who can also adapt the contract to your bot's logic, for example subscriptions or token-gated access. For details, see Custom smart-contract development, Accept non-custodial crypto payments, and Accept crypto to your own wallet.
Run it day to day
- Subscriptions. Crypto payments are not charged automatically each month. Let customers top up a balance in your service and deduct the subscription from it on your schedule, or send a new payment button before each period.
- Payments that arrive late or short. A crypto payment request is valid for 60 minutes without conversion and 15 minutes with conversion. A late payment is returned to the customer or, in some cases, credited to you. Your underpayment and overpayment settings decide whether a short or larger payment completes the order. See Payment handling.
- "I paid, but the bot is silent." Check the order status in your backend or through the API before answering; the customer may have paid on another network or after the request expired. See A customer says the payment is confirmed, but the order is not paid.
- Refunds. Volet.com does not cancel completed payments. Refund customers yourself, for example with a transfer to their Volet.com account or a crypto payout.
- Fake bots. Tell customers which bot is yours, and never ask them to connect a wallet or pay outside your official bot and mini app.
- Accounting. Download statements and keep the Telegram user ID and order ID with each payment. See Account statements.
Good to know
- Telegram's rules come first. Digital goods used inside Telegram are paid in Telegram Stars. If you accept payments from the customer's own wallet inside a mini app (non-custodial payments), Telegram requires TON Connect for the wallet connection. Payments through Hosted Checkout or the API do not connect a wallet.
- Gateway review. Volet.com reviews each new gateway and the bot or website it serves.
- AML screening. Incoming crypto payments are screened; usually within normal processing time. See Transaction screening.
- Final transactions. Confirmed blockchain payments cannot be canceled or reversed.
- Limits. Your current limits are shown before you confirm each transaction. See Limits.
Costs
| Fee | Who pays | When |
|---|---|---|
| Processing fee | You; for balance payments, you can add it to the customer's amount | On each payment |
| Network fee of the crypto payment | Your customer | When they pay in crypto |
| Conversion | You | When the customer pays in a currency other than your settlement currency, except 1:1 conversions between USD, USDT, and USDC |
| Withdrawal or payout fees | You | When you withdraw or pay partners |
There are no setup or monthly fees on the Volet.com side. See the Business fees page. The exact fee is always shown before you confirm.
When you grow
- Pay partners or users from the bot's balance. See Let users top up and withdraw.
- Add a website to the same balance with Hosted Checkout or a CMS plugin. See Launch a paid online service.
For current offers, see the crypto payment gateway product page.
Related
- Hosted Checkout integration — payment requests, notifications, and signatures
- API integration — build your own payment screen
- Payment to an online service failed — what your customers see when something goes wrong
- Crypto payments in Telegram mini apps — a blog article on Telegram rules and costs
- Stablecoin payments savings calculator for business — a blog calculator: what client payments and contractor payouts cost you now and with stablecoins