# Telegram
## How to connect the payment system
### Payment system is built into Telegram.
In order to make payments inside the messenger, you need:
* connect payment system to bot in botfather bot
* go to the desired bot settings and in the menu select Payments
* following instructions to connect an accessible payment system and copy the issued token
## How to Invoice a Client
To send invoice to telegram use method
tg\_send\_invoice(provider\_token, platform\_id, title, description, currency, prices, photo\_url, payload, protect\_content, disable\_notification, need\_name, phone\_number, need\_email, reply\_to\_message\_id, reply\_markup, reply\_id) - the required parameters are highlighted in bold
**provider\_token** - token received in Botfather, after connecting the payment system
**platform\_id** - recipient - identifier of user, group or channel
**title** - item title, 1-32 characters
**description** - description of goods, 1-255 characters
**currency** - payment currency (RUB, USD, UAH and so on )
**payload** - the first part of the coin about payment, by default tg\_payment
**prices** - price breakdown (description below)
**photo\_url** - link to product picture
**disable\_notification** - 1 - send with notification, 0 - without notification
**protect\_content** - 1 copy and screenshot protection, 0 - unprotected
**need\_name** - 1 if you need a full username to complete the order, 0 - without asking for a name
**need\_phone\_number** - 1 if you require a user’s phone number to complete the order, 0 - without a request number
**need\_email** - 1 if you require an email address of the user to complete the order, 0 - without a mail request
**reply\_to\_message\_id** - the message id to which we respond, '' is not the answer
**reply\_markup** - keyboard, the first button should be a button with pay type
If one of the parameters need\_name, need\_phone\_number or need\_email is specified, the user will request the data before paying and save it to the client variables if the payment is successful. In the screenshot below the request for all data input:
**prices** - an array of arrays with data on the cost of goods and additional services (delivery, packaging, etc.). Displayed on the payment page. The amount shall be indicated either by an integer of 125 or by a fraction through point 120.25 For example: \[\["goods", 2000], \["VAT", 20.75], \["packaging", 100]
## Callback on payment
After successful payment in the chat with the user will come a colbeck as follows:
**phone\_best 4737685 2120.75 UAH 1955518436**
where phone\_best - payload - from the request for creation of invoice 473737685 - a chat id, to which originally was sent invoice 2120.75 - the full amount of payment UAH - currency 1955518436 - payment id in the merchant system
Also, if you requested a name, phone and/or email, the client will write down the variables:
**tg\_payment\_name, tg\_payment\_phone** and **tg\_payment\_email**
{% hint style="info" %}
In case of success, the kolbek will be sent to the user’s personal messages. To do this, the client and the bot must cooperate before payment (the client must be subscribed to the bot)!
{% endhint %}
{% hint style="info" %}
After receiving the hook about payment, the payment will be automatically confirmed, by answerPreCheckoutQuery .
{% endhint %}
## Examples
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]]` \
`result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'phoneW-200', 'Best Model on the Market', 'UAH', prices, 'https://images11.popmeh.ru/cropped.jpg', 'phone_best', 0, 0, 1, 0, 1)`
### Example with minimum parameter sets
`prices = [["an amazing product", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'The best bot ever!',`` ``'An amazing course! Be the best!'``, 'UAH', prices)`
### Example with a Keyboard
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Phone W-200', 'BEst Model on the Market', 'UAH', prices, 'https://helpix.ru/news/200405/181746/gf200_2.jpg', 'phone_best', 0, 0, 1, 1, 1, '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}], [{"text":"One more button", "callback_data": "One more button"}]]}')`
---
# 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/integrations/payment/telegram.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.