Pro platby v Telegramu nestačí přidat tlačítko a připojit službu. Je potřeba určit předmět prodeje, povolený platební scénář, pravidla potvrzení objednávky a postup vrácení peněz.
Před vývojem prověřte celou cestu: výběr produktu, výpočet částky, platbu, získání výsledku a kontaktování podpory. Způsob platby dohodněte spolu s typem produktu a trhem.
Telegram rozlišuje platby za digitální zboží a služby a platby za fyzické zboží a služby.
Pro prodej digitálního zboží a služeb uvnitř botů a Mini Apps jsou povinné Telegram Stars. Vlastní web s jinou platbou toto pravidlo pro prodej uvnitř Telegramu neruší. Pravidla digitálních plateb.
Pro fyzické zboží a služby je k dispozici spolupráce s externími poskytovateli plateb. Telegram předává platební data do příslušného procesu a podmínky služby závisí na vybraném poskytovateli. Dokumentace Telegram Payments.
Modelové příklady: objednávka fyzického produktu s doručením a nákup přístupu k digitálním materiálům v Telegramu vyžadují různá řešení. U kombinované nabídky samostatně určete, za co se platí a kde se výsledek poskytuje. Samotné označení „služba“ způsob platby neurčuje.
Pokud zařazení nabídky není jednoznačné, upřesněte požadavky platformy a poskytovatele ještě před návrhem. Nepočítejte s platbou kartou jako s univerzální variantou pro každý prodej.
Pro každý typ objednávky zapište:
U externího poskytovatele prověřte možnost připojení vaší firmy, podporované země a platební metody, poplatky, termíny výplat a řešení sporů. Porovnání těchto podmínek najdete v článku o výběru platební služby.
U Stars samostatně posuďte podmínky získání odměny a dostupnost příslušného procesu pro firmu. Cena, za kterou uživatel kupuje Stars, se automaticky nerovná výplatě prodejci: Telegram je popisuje jako rozdílné hodnoty. Podmínky platformy.
Dohodněte stavy: objednávka vytvořena, čeká na platbu, zaplacena, čeká na splnění, splněna, zrušena nebo refundována. Platbu a poskytnutí výsledku evidujte odděleně.
U standardního platebního požadavku Bot API vyžaduje kontrola před platbou odpověď bota do 10 sekund. V této fázi je potřeba ověřit, že objednávku lze stále splnit a její podmínky jsou aktuální. Schválení této kontroly samo o sobě platbu nepotvrzuje. Postup provedení platby.
Stav „Zaplaceno“ nastavujte po ověřené serverové události úspěšné platby. V integrovaném scénáři Bot API jde o successful_payment. Uchovejte vazbu platby na objednávku i identifikátor platby. Popis SuccessfulPayment.
Zavření platebního okna ani zpráva zákazníka „Zaplatil jsem“ nesmějí samy o sobě otevřít přístup k produktu. Opakovaná událost nesmí znovu splnit stejnou objednávku a nový nákup nesmí být blokován jako duplicita.
V Mini App nelze údaje uživatele ani částku považovat za důvěryhodné jen proto, že přišly z rozhraní. Server musí podle vašich pravidel ověřovat uživatele, objednávku a výpočet.
Telegram vyžaduje ověření dat initData před použitím na serveru a upozorňuje, že initDataUnsafe nelze považovat za důvěryhodná. Dokumentace Mini Apps.
Určete, jak se objednávka dostane do CRM, skladového systému nebo systému přístupů. Pokud je platba již potvrzená, ale integrace je dočasně nedostupná, musí se objednávka uchovat pro opětovné zpracování. Zákazníkovi zobrazte skutečný stav a odpovědné osobě pošlete upozornění na problém.
Před platbou musí zákazník rozumět tomu, co získá, za jakých podmínek a kam se může obrátit. Texty podmínek, údaje o prodejci a potřebné dokumenty pro vybrané trhy dohodněte s odpovědnými odborníky.
Pro digitální nákupy Telegram vyžaduje zpracování dotazů přes příkaz /paysupport. Určete pracovníka, který je bude řešit. Požadavky na platební podporu.
Bot API nabízí metodu refundStarPayment pro vrácení úspěšné platby ve Stars. U jiných způsobů se postup vrácení řídí integrací poskytovatele. Možnost částečné refundace ověřujte samostatně a neslibujte ji automaticky. Metoda vrácení Stars.
Popište, co se po vrácení peněz stane s přístupem, rezervací zboží a stavem CRM. Samostatně připravte postup pro situaci, kdy jsou peníze vráceny, ale aktualizace jiného systému selže.
Podmínky dokončení zahrňte do technického zadání bota. Do nákladů započítejte vedle platební obrazovky také stavy objednávek, integrace, řešení chyb a podporu; rozsah práce vysvětluje článek o ceně Telegram bota.
Pro jednání o vývoji Telegram bota a Mini App připravte karty platebních scénářů a údaje o používaných systémech. Obchodní nabídka pomůže dohodnout rozsah vývoje. Konkrétní způsob platby, dostupnost poskytovatele a aktuální pravidla Telegramu ověřte před realizací.