How to take card payments in a mini app
Payment inside a mini app goes through your own merchant account: YooKassa or T-Bank. The money reaches you directly and we are not part of the settlement at all. Here is what that means in practice.
Whose money and whose receipt
The payment is created in your merchant account and lands in your account. We do not hold it, do not forward it and take no percentage: our share is the monthly plan fee, and it does not depend on how much you sold.
Responsibility follows the same line: your till issues the receipt, refunds are made in its cabinet, and a dispute with a buyer is settled under your contract with it. If the till needs line items on the receipt, they are configured there.
What has to be connected
You need a contract with YooKassa or T-Bank and the keys from their cabinet. They are entered once in the editor, in the payment settings; until then the pay button in the app works but no payment is created — handy for assembling and checking the screens in advance.
The legal side is yours: a merchant account signs with a company, a sole trader or a self-employed person, and its document requirements are its own. The builder cannot speed that up.
What the buyer sees
Someone picks a product or a service, reaches the payment and pays by card without leaving the messenger. No returning to a website, no password: the app already knows who they are, from the messenger.
After payment the order reaches your Telegram and stays as a row in the app’s table, where its status is changed. No separate order system is needed to begin with.
Other questions
- Can payments be taken without a merchant account?
- Not inside the app: the payment is created by the merchant account. But the app works perfectly well without payment — a request, a booking or an order paid on delivery needs none.
- Do you take a commission on sales?
- No. The commission is your merchant account’s, under your contract with it. We take only the monthly plan fee.
- What if I am an organiser and the money should reach several people?
- Today the payment goes to one merchant account, the app owner’s. Splitting settlement between several recipients is not built yet.