Блог CZ
Chat bota a okno aplikace propojené s platbou, zásilkou, digitálním souborem a zpětnou smyčkou.
Telegram a automatizace

Platby v Telegram botovi a Mini App: co ověřit před vývojem

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.

Začněte tím, co zákazník kupuje

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.

Připravte kartu platebního scénáře

Pro každý typ objednávky zapište:

  • předmět prodeje a způsob poskytnutí výsledku;
  • zemi prodejce a cílové trhy;
  • měnu nebo Stars, složení částky a příslušné poplatky;
  • dostupného poskytovatele a požadavky na účet;
  • potřebu doručení, kontaktů nebo rezervace termínu;
  • okamžik rezervace zboží nebo místa;
  • události potvrzující platbu a splnění objednávky;
  • pravidla zrušení, vrácení peněz a podpory.

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.

Oddělte vystavení platebního požadavku, platbu a splnění objednávky

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.

Prověřte Mini App a serverovou část

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řipravte vrácení peněz a podporu

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.

Kontrolní seznam před spuštěním

  • Typ prodeje a povolený způsob platby jsou potvrzené.
  • Účet prodejce a potřebná připojení jsou připravené.
  • Cena, měna, doprava a celková částka se zobrazují před platbou.
  • Úspěšná, zamítnutá a zrušená platba jsou zpracované.
  • Jsou ověřené opakované stisky tlačítek a opakované doručení událostí.
  • Změna dostupnosti nebo podmínek před platbou nevytvoří nesplnitelnou objednávku.
  • Zaplacená objednávka se uchová při chybě CRM nebo poskytnutí přístupu.
  • Vrácení peněz se promítne do objednávky a propojených systémů.
  • Podpora je dostupná a oznámení i podmínky jsou lokalizované.
  • Jsou prověřené dohodnuté aplikace Telegramu, zařízení a postup obnovy po výpadku.

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í.