Open the chat with @BotFather in Telegram, click "Start" (/start command), then /newbot.

Give the bot a name and a username. The bot's name will be shown in the contact list and at the top of the chat, it can be non-unique. The username will be in the short link to the bot, and it must be unique.

Example:

If the username isn't taken, @BotFather will respond to you with the token, i.e. the "key" to access the created bot. Don't give this token to anyone else, even the YooMoney's or Telegram's support services.

Once you have the key, the bot is ready: you can add an icon and configure the dialog patterns for customers. You can also set up payments via the bot.

Send the /mybots command to @BotFather. Click on your bot's name.

This will open the bot's dashboard. Select Payments.

If you'd like to set up real payments right away, select Connect YooMoney: payments in the menu. If you'd like to test payments first, select Connect YooMoney: test (for test payments, take bank card details from a special page).

This will open the chat with the YooMoney bot, click "Start". After that, select "Sign in and grant access", authorize in YooMoney, and allow the bot to send data from your Merchant Profile.

If you need to change store, enter /start and click Change store.

Return to the chat with @BotFather. It'll send you the token required for payment acceptance. You can always view the token via BotSettings → Payments.

Implement the sendinvoice method from the Telegram payment API: your bot will start sending invoices to customers in response to this request. Invoices should include the price, name, product description, payload parameter, and provider_token parameter which is the token provided by @BotFather after you connected your bot to the YooMoney bot. Please note that payments for the demo store should not exceed 1,000 rubles.

If you set up fiscalization via YooMoney, you'll need to send data for fiscalization to YooMoney. To do this, add the following parameters to the request:

You can request the customer's phone number or email address earlier, during the chat with the bot. Then the first two parameters are not required, and provider_data with the receipt object would be enough.

If you need the customer to provide you with an address for delivery, implement the Shipping Query method. When the user provides the address, respond to this query with the answerShippingQuery method. Indicate the delivery methods and their prices in this method.

When the user confirms the payment, Telegram will send you a webhook with Update containing the PreCheckoutQuery object. You need to respond to this query within 10 seconds by calling the answerPreCheckoutQuery method.

If the payment is successful, you'll receivea notification from Telegram (webhook with SuccessfulPayment object). The bot can be programmed to perform a certain action after a successful payment: for example, it can activate a service or send content to the customer.

Find the provider_payment_charge_id parameter in the SuccessfulPayment object from the Telegram notification. It'll contain the transaction number in YooMoney. We recommend keeping this number: you can use it to find the payment in your Merchant Profile.

Click Start (/start command). You'll receive a message with instructions and a payment button.

Click Pay to open the payment form.

Click Payment method, enter your card details, and click Pay.

Confirm the payment by clicking Pay again.