Вопросы
Покупатель прислал меньше. Что будет?
Счёт останется open, в received будет полученная сумма. Страница оплаты попросит доплатить разницу на тот же адрес. Как только сумма сойдётся, счёт станет paid.
Прислал больше?
Счёт paid, received больше amount. Разницу вернуть или нет, решаете вы. Всё уйдёт на холодный кошелёк при сливе.
Доплата после оплаты тоже попадёт в received, если пришла до 7 дней после expires_at. Второго вебхука не будет. Сверяйтесь через GET /v1/invoices/{id}.
Заплатил после того, как время вышло?
Сервис следит за адресом ещё сутки, а если часть суммы уже пришла, 7 дней. Платёж зачтётся, счёт станет late_paid, придёт вебхук. Выдать товар или вернуть деньги, решаете вы. «Поздно» решает время блока, а не момент, когда сервис увидел перевод.
Отправил не в той сети или не тот токен?
Не зачтётся. Сервис считает только USDT Tether в сети счёта. Адрес в TRON и адрес в BSC разные, а QR для BEP20 содержит сеть и контракт. Если деньги всё же пришли, ключ от адреса хранится в базе. Вытащить их можно, но вручную: кнопки для этого в beast нет.
Пришло два перевода по половине?
Сложатся. Каждый перевод учитывается один раз по (tx, log index, получатель).
Есть возвраты через API?
Нет. Деньги уходят на ваш холодный кошелёк, возврат вы делаете оттуда сами.
Как быстро счёт становится paid?
TRC20: когда блок подтверждён, это около минуты. Плюс пауза до проверки: первые 10 минут счёт проверяется раз в 15 секунд, потом раз в минуту. BEP20: 15 блоков сверху, плюс до 15 секунд. Со вторым провайдером оплата ждёт и его подтверждения, обычно в том же проходе.
Нужно ли опрашивать API?
Нет, хватит вебхука. Но разумно раз в час сверить через GET /v1/invoices/{id} счета, по которым вебхук не пришёл.
Мой сервер лежал сутки. Вебхуки потеряны?
Нет. Повторы идут около 4 дней с паузой до 6 часов. События хранятся в базе.
Можно свою страницу оплаты?
Да. Возьмите address, amount и uri из ответа API. Страницу beast нельзя встроить в iframe, на неё отправляют ссылкой.
Почему не один адрес и уникальные суммы?
Так проще и надёжнее. Адрес принадлежит одному счёту, поэтому всё, что на него пришло, точно оплата этого счёта. Доплата и поздний платёж работают без угадывания.
Ключи выводятся из seed-фразы?
Нет. Каждый ключ случайный, из crypto/rand. Нет общей фразы, утечка которой открыла бы всё. Цена: бэкап базы нужен регулярно, а секрет нужен всегда.
Сколько счетов выдержит?
Сервис рассчитан на магазин, а не на биржу. Одна база SQLite. По умолчанию до 200 открытых счетов на сеть (MAX_OPEN_INVOICES). TRC20 проверяет не больше 20 адресов за 15 секунд, по очереди, живые счета первыми. Чем больше счетов, тем реже каждый, так что ключ TronGrid очень нужен. BEP20 делает один запрос на каждые 50 адресов и следит не больше чем за 500 адресами сразу.
На старый пустой адрес пришли деньги через месяц?
В счёт он не попадёт: окно наблюдения уже закрыто. Но слить можно. Нажмите в админке «Проверить все адреса»: оценка и слив пройдут по всем адресам за всё время.
Потерял DEPOSIT_KEY_SECRET.
Неслитые деньги не вернуть. Слитые лежат на холодном кошельке и в безопасности. Сделайте новый секрет и новую базу. Поэтому офлайн-копия секрета обязательна.