Версия 0.1.3 · Команды установки используют точные версии.
Ошибки API, неопределённые платежи и сетевые сбои
Различайте ошибки параметров, API, flood wait, недоступности, ответа и сети без раскрытия секретов.
SDK разделяют локальную валидацию, ошибку API, rate limit, временную недоступность, неправильный JSON/ответ и timeout сети. Безопасное сообщение не включает заголовки или исходный текст исключения транспорта.
Проверяйте одновременно HTTP-статус и ok. JSON с ok=false не является успехом даже при HTTP 200. Ошибки могут использовать error, reason или info; дополнительные поля сохраняются.
Платёж с unconfirmed или tx_hash нужно сверить, а не повторить. SDK не выдумывает endpoint поиска заказа, время доставки или отсутствующую гарантию идемпотентности.
HTTP 400 с ok=false и unconfirmed=true вызывает PurchaseOutcomeUnknownError (или аналог языка), с outcome_unknown=true и безопасно очищенными details, включая tx_hash. Это не обычный отказ валидации: средства уже могли уйти. Сверьте вручную; автоматического повтора покупки нет.
Читайте дальше
Telegram Stars API: 429, Retry-After и flood wait · Защита данных кошелька при интеграции API · Вопросы об API и SDK Fragment Donor