Telegram Stars: защо не можете да продадете курс срещу плащане с карта

Заявката идва почти с едни и същи думи. Клиентът има аудитория в Telegram, има курс или затворена общност за продан и има разработчик, на когото вече са казали просто да „сложи плащане с карта в бота“. Понякога дори има готов профил при доставчик на плащания. Отговорът е, че това не може да се построи по този начин, и причината не е приумица на Telegram, която се заобикаля с находчива интеграция. Това е правило на магазините за приложения, предадено директно на вас.

По-нататък: какво точно пише в документацията, защо е устроено така, какво е длъжен да може бот, който приема пари, кой плаща при спорна транзакция и какво прави курсът на Stars с ценообразуването ви още преди да сте назовали сума.

Формулировката, която заслужава да се прочете буквално

Документацията на Telegram е разделена на две части и точно това разделение е същината. Страницата за физически стоки и услуги описва обичайните валути и външните доставчици на плащания. Страницата за цифрови стоки и услуги описва всичко останало и не оставя място за тълкуване: всички плащания през ботове и mini apps за цифрови стоки и услуги вътре в приложенията на Telegram трябва да се извършват изключително в Telegram Stars, за да отговарят на правилата на App Store и Play Store.

Технически това означава, че полето за валута на фактурата носи етикета XTR, параметърът provider_token остава празен, защото в схемата няма трета страна, а потребителят плаща със звезди, купени от Telegram предварително. Stars се появиха в Bot API 7.4 през май 2024 г., списъкът с транзакции дойде в 7.5, а абонаментите със звезди – в 8.0 през ноември същата година. Промените по Bot API са единственото място, което си струва да се проверява за актуалния набор от методи, защото той се мени по няколко пъти годишно.

Защо ограничението съществува и защо това има значение

Правило, чиято причина разбирате, става предвидимо. Telegram не я оставя на догадки: за да спазва платежните политики на Google и указанията на Apple по точки 3.1.1, 3.1.1(a) и 3.1.3(b), ботът или mini app трябва да използва Stars за продажба на цифрови стоки вътре в приложенията на Telegram, независимо какви уебсайтове, услуги или доставчици на плащания сте настроили извън екосистемата.

Веригата е кратка. Telegram е приложение, което се разпространява през App Store и Google Play. И двата магазина изискват цифровото съдържание, което се потребява вътре в приложение, да се продава през техните собствени механизми за покупки в приложението. Telegram Stars са точно този механизъм, опакован така, че хиляди независими ботове да ползват една съвместима с правилата релса. Вашият бот живее вътре в Telegram, следователно вашият бот наследява задължението.

Условията за разработчици на Bot Platform добавят клауза, която обикновено се пропуска при четене: Telegram е длъжен да следва определенията за цифрови стоки и услуги, които дават Apple и Google, тези определения може да се променят с времето, а на разработчиците се препоръчва да сверяват директно с документацията на магазините. Тоест границата между „цифрово“ и „физическо“ не се тегли от месинджъра и не е закована завинаги. Ако продуктът ви стои близо до нея, гледайте към Apple и Google, а не към Telegram.

Какво продавате, с какво може да се плати, какво трябва да построите

Неудобните случаи лежат между петия и шестия ред. Индивидуална консултация по видеовръзка не е очевидно физическа услуга и Telegram няма да отсъди вместо вас. Ориентирът тук са правилата на магазините, а когато класификацията наистина е неясна, проектирайте така, че плащането да се случва на вашия сайт, а не в чата. Отделно за продавач в Европейския съюз остава задължението да съгласува собствените си условия и правото на отказ с местното потребителско законодателство. Telegram не поема тази част.

Какво е длъжен да може бот, който приема пари

• /terms или също толкова лесен достъп до вашите общи условия, които купувачът трябва да потвърди преди покупката.
• /support или друг ясно съобщен канал за поддръжка, заедно с предупреждението, че поддръжката на Telegram не помага при покупки във вашия бот.
• /paysupport – отделна команда точно за платежни въпроси, записана в условията за разработчици. Тя се забравя най-често.
• answerPreCheckoutQuery в рамките на десет секунди, иначе транзакцията се отменя. Това е реално ограничение за всяка синхронна проверка на наличност или права.
• Запазване на telegram_payment_charge_id от известието за успешно плащане. Без него по-късно не може да се направи възстановяване.
• Доставка само след successful_payment. Отговорът на pre-checkout не гарантира плащане и смесването на двете е класически начин да раздадете продукта безплатно.

Това не е тежко инженерство. Това е горе-долу ден работа, който решава дали ботът ще преживее първия спор. Същата дисциплина важи и за останалите сценарии: къде разговорната автоматизация наистина замества човек и къде не, разгледахме в материала за Telegram бот вместо мениджър.

Възстановявания, спорове и кой плаща сметката

Възстановяването се прави с метода refundStarPayment, купувачът получава пълната сума и Telegram не налага санкция. Това е лесната половина. Трудната е записана в условията за разработчици: обработката на основателните спорове е изцяло върху продавача, Telegram няма задължение да посредничи, а ако спорът завърши с връщане, средствата излизат от вашия баланс.

Telegram отива и по-нататък, като изрично не препоръчва продажба в реално време на цифрови продукти и виртуални предмети, които имат собствена стойност и не могат да бъдат отнети след успешен chargeback от купувача. Това се чете буквално. Ако продуктът ви се потребява мигновено и не може да се отзове, измамата е за ваша сметка. Неразрешените основателни спорове могат да струват отписани звезди, премахване на бота от платформата, публичен етикет за измама и прекратяване на акаунта на собственика.

На практика това означава собствен регистър на достъпите извън Telegram, за да може достъпът да се отнеме, когато парите се върнат. Това вече е въпрос на интеграции, а не на бот, и е същият архитектурен проблем, описан в нашето ръководство за свързване на сайта с CRM и складова система.

Икономиката, казана честно

Звездите не са валута, която притежавате. Условията са категорични: Stars по баланса на бота са собственост на Telegram и нямат собствена стойност извън добросъвестния ангажимент за рекламни кредити и възнаграждения. Две публикувани ставки имат значение.

• Възнаграждение: 0,013 USD за звезда. Това е стойността, в която разработчикът превръща звездите, като обработката минава през Fragment.
• Рекламен кредит: 0,02 USD за звезда. Звезди, похарчени за реклама на собствения бот в Telegram, струват осезаемо повече от звезди, взети като възнаграждение.

Има и забавяне: звездите може да не станат достъпни за възнаграждение или рекламен кредит до двадесет и един дни след получаването им. Telegram отделно заявява, че стойността на възнаграждението няма никаква връзка, пряка или подразбираща се, с това колко потребителят е платил за звездата в конкретен регион. Потребителите купуват звезди през покупките в приложението на Apple и Google, така че в цената, която виждат, вече са вградени комисионата на магазина и местното ДДС.

Таблицата е аритметика върху публикуваната от Telegram ставка към датата на писане, а не прогноза. Telegram заявява, че определя тази стойност по свое усмотрение и че тя може да се промени. Оттук следват два извода. Първо, задавайте цената в звезди и след това я превеждайте по ставката на възнаграждението, за да видите долната граница на приходите, вместо да тръгвате от сума в евро и да делите. Второ, ако така или иначе купувате реклама в Telegram, харченето на спечелените звезди за реклама струва повече на звезда, отколкото изтеглянето им, и това е реална стратегическа опция, а не закръгляне.

Три архитектури, които работят

Пълен чекаут със звезди в бота. Подходящ за евтини и масови цифрови артикули, при които излизането от чата убива конверсията. Ставката на възнаграждението в този случай е цената на удобството.

Ботът е фунията, сайтът е касата. Ботът квалифицира, отговаря и подава човека към страница, където парите приема обичаен доставчик. Вътре в Telegram не се продава нищо, така че изискването за Stars не се прилага. Това е стандартният отговор за всичко с сериозна стойност на поръчката и оставя клиентските данни, фактурирането и възстановяванията в системи, които са ваши. Цената е отпадането при прехода, което се измерва и обикновено е по-малко от разликата в ставките.

Разделяне по тип продукт. Физическите стоки и услугите на място през доставчик, цифровите добавки в звезди, един бот и два потока. Повече код, но по-близо до това как бизнесът наистина продава. Нашият случай с образователна платформа и направлението разработка на Telegram ботове стъпват точно на този модел и той се връзва добре с останалата част от стека, описана в материала за това откъде да започне автоматизацията на маркетинга.

Решения, които се взимат преди първия ред код

• Класифицирайте всяка позиция спрямо определенията на магазините, а не спрямо интуицията. Класификацията определя платежната релса, релсата определя архитектурата.
• Решете къде пристигат парите, преди да рисувате фунията. Преправянето на касата е много по-скъпо от избора ѝ наведнъж.
• Смятайте цената от ставката на възнаграждението, а не от сумата, която вижда купувачът. Разликата между двете не подлежи на договаряне.
• Постройте отнемането на достъп едновременно с даването му. Възстановяването е пълноценен сценарий, а не краен случай.
• Пуснете /paysupport и /terms още в първата версия. Сега е евтино, след оплакване не е.

Накратко

Цифровите стоки, продавани вътре в Telegram, се плащат само със звезди с етикет XTR, защото Apple и Google изискват покупки в приложението за цифрово съдържание, а Telegram предава това изискване нататък. Физическите стоки и реалните услуги все още могат да минават през обичайни валути и външни доставчици. Всеки бот, който взема пари, дължи /terms, /support и /paysupport, и то преди пускането. Възстановяванията минават през refundStarPayment, а целият риск от спорове и chargeback е върху продавача, включително с отделно предупреждение на Telegram срещу мигновено потребимите артикули. А ставката от 0,013 USD за звезда срещу рекламен кредит от 0,02 USD и задържане до двадесет и един дни е входна данна за ценообразуването, а не счетоводна подробност.

Нищо от това не прави продажбите в Telegram лоша идея. Прави ги проектно ограничение, което или се планира в началото, или се открива в най-неподходящия момент.