Telegram Bot Payments are a free and open platform that allows sellers to accept payments for goods and services from Telegram users. Telegram doesn't collect payment information and takes no commission. This page covers payments for physical goods and services – if you’re interested in selling digital goods and services, please check out our dedicated page.
Note: This article is intended for bot developers and store owners. If you're looking for a general overview of Telegram Payments for physical goods and services, check out the Telegram blog.
If you are new to Telegram bots and would like to learn how to create and set up a bot, please consult our Introduction to Bots and Bot FAQ.
Payments for physical goods and services were first added to Telegram in 2017 and allow bots to:
@ShopBot ...
in any chat for an inline invoice.Check out @ShopBot for an example of a virtual storefront – then use our dedicated guides for digital and physical products to build your own.
You create a bot that offers goods and services to Telegram users. Merchant bots can send specially formatted invoice messages to users, groups or channels. If your bot supports inline mode, users can also send invoices to other chats via the bot, including to one-on-one chats with other users.
Invoice messages feature a photo and description of the product along with a prominent Pay button. Tapping this button opens a special payment interface in the Telegram app. In this interface, users can choose a tip amount (if allowed by the merchant) and enter additional details like shipping info, phone number, or email address.
The bot can offer several shipping options for physical goods based on the delivery address. When ready, users enter their credit card info or choose a saved card — and pay for the product. Telegram also supports Apple Pay and Google Pay. Once the transaction is done, the merchant bot can send a receipt message with payment details, shipping and delivery information.
Detailed information and step-by-step instructions are available below.
Telegram does not process payments from users and instead allows developers to integrate directly with different third-party payment providers around the world. It is the payment providers that handle and store all sensitive information, like credit card details. Neither Telegram nor the bot developers have access to it.
Payments from more than 200 countries are supported via the following payment providers:
We continue expanding this list, follow @BotNews for updates.
If you work for a company that provides services similar to standalone accounts in Stripe Connect, please let us know via @BotSupport (include the hashtag
#paymentsprovider
in your message).
This section explores payments via Telegram's Bot API in more detail.
To start accepting payments, you need a Telegram bot. Use BotFather to create a bot if you don't have one already.
Now you have a merchant bot that can offer goods or services to Telegram users. Let's call it @merchantbot
in this document. The first stop is to choose and connect a payment provider, you can find the list of supported providers above.
/mybots
command in the chat with BotFather and choose the @merchantbot
that will be offering goods or services.You will find the necessary methods for building your payment implementation in the Payments Section of the Bot API Manual.
While you're still developing and testing payments for your bot, use the “Stripe TEST MODE” provider. When in this mode, you can make payments without actually billing any accounts. Real cards can't be used in test mode, but you can use test cards like 4242 4242 4242 4242
(full list here). You can switch between test mode and live mode as many times as you want, but please see the live checklist before you go live.
See Bot API: Payments for the complete list of available methods and objects.
The user contacts @merchantbot
and requests to purchase something. The bot forms an invoice message with a description of the goods or service, amount to be paid, and requested shipping info. There are two ways of creating an invoice:
Use the sendInvoice method to generate an invoice and send it to a chat. The provider_token parameter is where you put the token value that you've obtained earlier via Botfather. It is possible for one merchant bot to use several different tokens for different users or different goods and services.
Invoice messages with a pay button can be sent to chats of any type: private chats with the user, groups, or channels. The resulting invoice message will look like this:
If @merchantbot
supports inline mode, you can use inputInvoiceMessageContent to allow users to share invoices for your goods and services to their one-on-one chats with friends, or to their groups and channels. These invoices will have a Pay button that can be used multiple times.
There are two ways for handling forwarded copies of your invoices, controlled by the parameter start_parameter in the sendInvoice method.
If a single-chat invoice is sent to the chat with @merchantbot
, it can only be paid once. If a single-chat invoice is sent to any other chat, it can be paid many times by many users.
To get a better understanding of how this works, try toggling the “Pay from Forwards” parameter when creating invoices with our demo @ShopBot.
Regardless of whether or not the Pay button is available in an invoice, the merchant bot always has the power to decide whether or not to accept new payments for a particular invoice.
If the max_tip_amount parameter is set to above 0
, users can add a tip to their payment. You can use the parameter suggested_tip_amounts to suggest particular amounts that you feel will be relevant for the invoice.
The user specifies shipping information or other info requested by the bot. This could be the user's full name, an email address, a phone number in international format, or a full postal address for delivery.
If a shipping address was requested and you included the parameter is_flexible, the Bot API will send an Update with a shipping_query field to the bot. The bot must respond using answerShippingQuery either with a list of possible delivery options and the relevant delivery prices, or with an error (for example, if delivery to the specified address is not possible).
Tip: It is recommended that the merchant bot confirms availability of the goods/services at this step – to let the user know in case they are no longer available. This is especially important if you are using multi-chat, inline or single-chat, multi-use invoices.
The user selects a delivery option from the list (the overall amount to be paid may change at this point) and proceeds to checkout.
The user enters their payment information and presses the final pay button. At this moment the Bot API sends an Update with the field pre_checkout_query to the bot that contains all the available information about the order. Your bot must reply using answerPrecheckoutQuery within 10 seconds after receiving this update or the transaction is canceled.
The bot may return an error if it can't process the order for any reason. We highly recommend specifying a reason for failure to complete the order in human readable form (e.g. "Sorry, we're all out of rubber ducks! Would you be interested in a cast iron bear instead?"). Telegram will display this reason to the user.
Warning: It is critical to make sure your bot only accepts multiple payments when the order can be processed correctly. This is especially important if you are using multi-chat, inline or single-chat, multi-use invoices.
In case the bot confirms the order, Telegram requests the payment provider to complete the transaction. If the payment information was entered correctly and the payment goes through, the API will send a receipt message of the type successful_payment from the user. Once your bot receives this message, it should proceed with delivering the goods or services purchased by the user.
If the invoice message was sent in the chat with @merchantbot
, it becomes a Receipt in the UI for the user — they can open this receipt at any time and see all the details of the transaction:
If the message was sent to any other chat, the Pay button remains and can be used again. It is up to the merchant bot whether to actually accept multiple payments.
Once you've tested everything and confirmed that your payments implementation works, you're ready to switch to LIVE MODE. To do this, go to BotFather > /mybots > select @merchantbot
> Bot Settings / Payments and enable Stripe LIVE MODE. You will get a token that has the string :LIVE:
in the middle, e.g. 123:LIVE:XXXX
. Do not give this token to any third parties!
Before your merchant bot goes into live mode, please ensure the following:
If you work for a company that provides services similar to standalone accounts in Stripe Connect, please let us know via @BotSupport (kindly include the hashtag #paymentsprovider
in your message).
Telegram does not charge any commission for using the Payments API. Note though, that most payment providers will have their own commissions. For example, Stripe in the US charges 2.9% + 30¢ per successful card charge (see the Stripe website for more details on pricing).
Yes. If you are not a developer, you will need to either hire someone to make a bot for you (recommended), or use a bot created by a third-party company. We advise extreme caution when using services of bots that process payments for you – Telegram doesn't maintain any such bots and doesn't endorse any of the third-party bots offering these services.
Telegram does not impose any limits on what products or services your bot can offer. But please note that you must comply with the rules of the payments provider you choose in our system. E.g., Stripe has a special page for prohibited businesses – you may want to consult that one before you start selling harvested organs.
Special Note: Due to Apple's limitations, bot developers are currently not allowed to accept payments for digital goods and virtual services from iOS users.
UPD 2024: Thanks to recent changes in the Apple Review Guidelines, users will soon be able to pay for digital goods and services with Telegram Stars on all platforms.
Telegram acts as a messenger between the paying user, the bot developer, and their chosen payment system. The user sends their credit card details directly to the payment system. Then the payment system's response and the shipping details entered by the user are passed to the bot developer so that they can process the order.
Since Telegram doesn‘t process the payments, we don’t store and can‘t access any sensitive data. Due to this structure, it is impossible for Telegram to handle complaints or cashbacks – any disputed payments are the responsibility of the bot developers, payment providers, and banks that participated in the exchange.
See also: Telegram Privacy Policy
You are welcome to study the MTProto payment documentation.
Telegram payments currently support the currencies listed below (here's a JSON version in case you need it).
If you're using Stripe as the payments provider, supported currencies may vary depending on the country you have specified in your Stripe account (more info).
The minimum and maximum amounts for each of the currencies roughly correspond to the limit of US$ 1-10000
. The amount must be expressed in 12 digits or less, so the maximum value will be correspondingly lower for some lower-value currencies. Note that for each currency except USD these limits depend on exchange rates and may change over time (plan ahead for this when you implement limits in your code).
Code | Title | Min amount | Max amount |
---|---|---|---|
AED | United Arab Emirates Dirham | AED 3.67 | AED 36,730.50 |
AFN | Afghan Afghani | AFN67.99 | AFN679,896.12 |
ALL | Albanian Lek | 93,61ALL | 936.077,51ALL |
AMD | Armenian Dram | 402.02 AMD | 4,020,243.92 AMD |
ARS | Argentine Peso | ARS 1.012,25 | ARS 10.122.452,03 |
AUD | Australian Dollar | AU$1.55 | AU$15,540.74 |
AZN | Azerbaijani Manat | 1,70 AZN | 17 025,94 AZN |
BAM | Bosnia & Herzegovina Convertible Mark | 1,86 BAM | 18.605,76 BAM |
BDT | Bangladeshi Taka | BDT 119.42 | BDT 1,194,181.78 |
BGN | Bulgarian Lev | 1,86 BGN | 18 595,60 BGN |
BHD | Bahraini dinar | BHD 0.377 | BHD 3,770.320 |
BND | Brunei Dollar | BND1,35 | BND13.456,05 |
BOB | Bolivian Boliviano | BOB 6,91 | BOB 69.054,41 |
BRL | Brazilian Real | R$ 6,04 | R$ 60.414,01 |
BYN | Belarusian ruble | 3,27 BYN | 32 704,84 BYN |
CAD | Canadian Dollar | CA$1.41 | CA$14,069.65 |
CHF | Swiss Franc | 0.88 CHF | 8'838.80 CHF |
CLP | Chilean Peso | CLP 975 | CLP 9.752.301 |
CNY | Chinese Renminbi Yuan | CN¥7.27 | CN¥72,704.02 |
COP | Colombian Peso | COP 4.427,50 | COP 44.275.000,00 |
CRC | Costa Rican Colón | CRC507,33 | CRC5.073.297,88 |
CZK | Czech Koruna | 23,92 CZK | 239 203,20 CZK |
DKK | Danish Krone | 7,09 DKK | 70868,85 DKK |
DOP | Dominican Peso | DOP60.35 | DOP603,506.50 |
DZD | Algerian Dinar | DZD 133.82 | DZD 1,338,184.83 |
EGP | Egyptian Pound | EGP 49.81 | EGP 498,114.04 |
ETB | Ethiopian Birr | ETB126.60 | ETB1,266,009.00 |
EUR | Euro | 0,95 € | 9 502,35 € |
GBP | British Pound | £0.79 | £7,867.80 |
GEL | Georgian Lari | 2,84 GEL | 28 401,26 GEL |
GHS | Ghanaian cedi | GHS14.99 | GHS149,914.38 |
GTQ | Guatemalan Quetzal | GTQ7.71 | GTQ77,141.88 |
HKD | Hong Kong Dollar | HK$7.78 | HK$77,833.55 |
HNL | Honduran Lempira | HNL 25.30 | HNL 253,046.55 |
HRK | Croatian Kuna | 7,13 HRK | 71.332,59 HRK |
HUF | Hungarian Forint | 392,99 HUF | 3 929 900,60 HUF |
IDR | Indonesian Rupiah | IDR15.888,00 | IDR158.880.000,00 |
ILS | Israeli New Sheqel | ₪ 3.62 | ₪ 36,157.05 |
INR | Indian Rupee | ₹84.73 | ₹847,265.02 |
IQD | Iraqi dinar | IQD 1,309.183 | IQD 13,091,829.260 |
IRR | Iranian rial | 42,087/49 IRR | 420,874,947/90 IRR |
ISK | Icelandic Króna | 138 ISK | 1.382.703 ISK |
JMD | Jamaican Dollar | JMD157.31 | JMD1,573,066.84 |
JOD | Jordanian dinar | JOD0.709 | JOD7,091.030 |
JPY | Japanese Yen | ¥150 | ¥1,503,020 |
KES | Kenyan Shilling | KES129.42 | KES1,294,197.91 |
KGS | Kyrgyzstani Som | 86-79 KGS | 867 946-84 KGS |
KRW | South Korean Won | ₩1,416 | ₩14,159,450 |
KZT | Kazakhstani Tenge | KZT525-11 | KZT5 251 071-40 |
LBP | Lebanese Pound | LBP 89,600.00 | LBP 896,000,001.43 |
LKR | Sri Lankan Rupee | LKR 290.21 | LKR 2,902,139.48 |
MAD | Moroccan Dirham | MAD 9.97 | MAD 99,718.42 |
MDL | Moldovan Leu | 18.30 MDL | 182,983.10 MDL |
MMK | Myanmar kyat | MMK3,247.96 | MMK32,479,609.92 |
MNT | Mongolian Tögrög | MNT3 398,00 | MNT33 979 999,46 |
MOP | Macanese pataca | MOP8.01 | MOP80,132.04 |
MUR | Mauritian Rupee | MUR46.70 | MUR467,049.62 |
MVR | Maldivian Rufiyaa | 15.40 MVR | 154,028.66 MVR |
MXN | Mexican Peso | MX$20.30 | MX$202,970.96 |
MYR | Malaysian Ringgit | MYR4.43 | MYR44,324.99 |
MZN | Mozambican Metical | MZN63.90 | MZN639,039.80 |
NGN | Nigerian Naira | NGN1,628.06 | NGN16,280,596.73 |
NIO | Nicaraguan Córdoba | NIO 36.78 | NIO 367,773.67 |
NOK | Norwegian Krone | NOK 11,04 | NOK 110 404,01 |
NPR | Nepalese Rupee | NPR135.51 | NPR1,355,111.83 |
NZD | New Zealand Dollar | NZ$1.70 | NZ$17,035.60 |
PAB | Panamanian Balboa | PAB 1.00 | PAB 9,993.44 |
PEN | Peruvian Nuevo Sol | PEN 3.73 | PEN 37,345.65 |
PHP | Philippine Peso | PHP58.11 | PHP581,070.08 |
PKR | Pakistani Rupee | PKR277.67 | PKR2,776,662.75 |
PLN | Polish Złoty | 4,07 PLN | 40 670,58 PLN |
PYG | Paraguayan Guaraní | PYG 7.797 | PYG 77.968.778 |
QAR | Qatari Riyal | QAR 3.64 | QAR 36,435.24 |
RON | Romanian Leu | 4,73 RON | 47.281,96 RON |
RSD | Serbian Dinar | 111,14 RSD | 1.111.420,25 RSD |
RUB | Russian Ruble | 110,24 RUB | 1 102 411,71 RUB |
SAR | Saudi Riyal | SAR 3.76 | SAR 37,575.20 |
SEK | Swedish Krona | 10,92 SEK | 109.205,30 SEK |
SGD | Singapore Dollar | SGD1.34 | SGD13,426.25 |
SYP | Syrian pound | SYP 2,512.53 | SYP 25,125,298.58 |
THB | Thai Baht | ฿34.21 | ฿342,095.00 |
TJS | Tajikistani Somoni | 10;91 TJS | 109 075;17 TJS |
TRY | Turkish Lira | 34,74 TRY | 347.445,00 TRY |
TTD | Trinidad and Tobago Dollar | TTD6.78 | TTD67,789.84 |
TWD | New Taiwan Dollar | NT$32.43 | NT$324,297.93 |
TZS | Tanzanian Shilling | TZS2,630.00 | TZS26,300,000.07 |
UAH | Ukrainian Hryvnia | 41,62UAH | 416 174,92UAH |
UGX | Ugandan Shilling | UGX3,678 | UGX36,777,017 |
USD | United States Dollar | $1.00 | $10,000.00 |
UYU | Uruguayan Peso | UYU 43,15 | UYU 431.498,64 |
UZS | Uzbekistani Som | 12 843,54 UZS | 128 435 392,27 UZS |
VND | Vietnamese Đồng | 25.398 ₫ | 253.975.000 ₫ |
YER | Yemeni Rial | YER 250.40 | YER 2,503,999.25 |
ZAR | South African Rand | ZAR 18.16 | ZAR 181,554.01 |