Выставление счетов: бот, мини-приложение и кабинет

Счёт можно создать тремя способами: в Telegram-боте, в веб-кабинете или через API. Результат одинаковый — ссылка на страницу оплаты, которую вы отправляете покупателю. Выбирайте способ по ситуации: бот удобен на ходу, кабинет — за компьютером, API — для автоматизации.

Способ 1: через бота

Откройте проект в боте, перейдите в раздел счетов и нажмите ➕ Создать счет:

1. Сумма. Введите сумму в долларах США — например 0.50, 77 или 77.50. Точную сумму в USDT или USDC сервис рассчитает сам.
2. Описание. Введите назначение платежа (от 1 до 256 символов) — его увидит покупатель на странице оплаты. Шаг можно пропустить.
3. Проверка. Бот покажет черновик счёта. Здесь можно изменить сумму или описание, а также нажать 🗒 Добавить заметку для себя — приватный комментарий до 160 символов, который покупатель никогда не увидит (например, имя клиента или номер заказа).
4. ✅ Создать счет. Бот пришлёт готовый счёт: сумму к оплате, сеть, адрес и ссылку на оплату с QR-кодом.

Счёт, созданный через бота, действует 30 минут. Если покупатель не успел, отменённый или истёкший счёт нельзя оплатить — создайте новый: у него будет новая уникальная сумма.

Способ 2: через веб-кабинет

В кабинете (бот → Войти в личный кабинет) откройте раздел «Счета» → «Новый счёт». Форма та же — сумма, публичное описание, заметка для себя, — но за компьютером удобнее работать с историей: фильтровать счета по статусу, просматривать детали и копировать ссылки повторно.

Кабинет — единственное место, где видна полная история всех счетов проекта и статистика оплат.

Публичное описание и заметка для себя

Это два разных поля, и их легко перепутать:

• Описание видит покупатель — пишите то, что поможет ему узнать свой заказ: «Доступ на 30 дней», «Заказ #481».
• Заметка для себя видна только вам в боте и кабинете — туда удобно записывать клиента или внутренний номер сделки.

Какую ссылку отправить покупателю

У каждого счёта две равнозначные ссылки:

• Ссылка на checkout — открывается в любом браузере: сумма, выбор сети, адрес, QR-код и живой статус. Универсальный вариант: работает у покупателя без Telegram.
• Ссылка на бота — открывает счёт в GramPayBot, кнопка оплаты ведёт в тот же счёт внутри Telegram Mini App. Удобно, когда переписка и так идёт в Telegram.

Покупателю не нужно ничего устанавливать или регистрироваться — он просто открывает ссылку и платит со своего кошелька или биржи. Обе страницы показываются на языке, который выбран в настройках приложения.

После оплаты

Когда перевод подтверждается в блокчейне, счёт автоматически меняет статус на «оплачен», а вы получаете сообщение в Telegram — с суммой, сетью и хэшем транзакции. Из карточки счёта можно скопировать хэш или открыть транзакцию в блокчейн-эксплорере. Что видит покупатель в процессе — в разделе «Что видит покупатель на странице оплаты».