Заказчик продаёт цифровой товар - платные шаблоны и доступ к закрытой библиотеке файлов.
Покупатели в основном не из России, картой российского банка им платить нечем, а стейблкоины у них уже есть на бирже.
До меня всё шло руками: человек писал в личку, ему кидали адрес кошелька, он присылал скриншот перевода.
Заказчик открывал обозреватель и сверял глазами - тот адрес, та сумма, пришло или ещё висит.
При двух-трёх покупателях в день это терпимо, дальше начались потери: перевод без комментария невозможно привязать к заказу, то-есть человек оплатил, а кому выдавать - непонятно.
Отдельная боль - курс: пока покупатель ходил на биржу, цена уезжала, и приходил перевод то на доллар меньше, то на два больше.
Попросили Mini App, где приложение само выдаёт реквизиты, само видит платёж и само отдаёт товар.
Mini App на React, бот и бэкенд - Python, aiogram 3 и FastAPI, база PostgreSQL, блокировки и кэш курса на Redis.
На каждый заказ выписывается инвойс: сумма в USDT или TON, адрес, свой комментарий-идентификатор и живой срок в 15 минут.
Курс тянется с биржи, фиксируется на эти 15 минут и на экране идёт обратный отсчёт - после него сумма пересчитывается заново.
Платёжная ссылка ton:// и QR рядом, кнопка открывает кошелёк с уже подставленной суммой и комментарием.
Часть переводов приходит прямо с биржи, а биржа комментарий нередко режет - под такие случаи держу пул одноразовых адресов и привязываю платёж по адресу.
За блокчейном приложение следит само: вебхук от индексера как основной канал и свой опрос ноды раз в 20 секунд как страховка, если вебхук не дошёл.
Оплата подтверждается не по факту появления транзакции, а по числу подтверждений - до этого заказ висит в статусе «ждём сеть».
Повторный зачёт закрыт жёстко: пара lt и hash транзакции лежит в уникальном индексе, зачисление и выдача идут одной транзакцией базы.
Недоплата не роняет заказ - показывается остаток и кнопка доплатить на тот же адрес, переплата падает на внутренний баланс и уходит в следующую покупку.
После подтверждения товар выдаётся сам: ссылка на файлы и персональный ключ доступа приходят в чат, ручной пересылки больше нет.
Вывод сделал в две стороны - на биржевой депозит с memo и на личный кошелёк владельца, оба адреса заранее внесены в белый список.
Так-же есть история операций с фильтром по статусу и выгрузка в CSV - для сверки и для бухгалтера.
Весь сценарий сначала гонял в тестовой сети, включая недоплату, двойную отправку и оплату после истечения инвойса, и только потом переключил на боевую.
Оплата перестала быть перепиской: покупатель жмёт кнопку, переводит и получает доступ, не дожидаясь ответа продавца.
От перевода до выдачи проходит около минуты - большую часть занимают подтверждения сети, а не мой код.
За первый месяц через приложение прошло 212 платежей, семь из них пришли недоплатой и закрылись доплатой без моего участия.
Потерянных переводов не осталось совсем - всё, что пришло на адреса приложения, привязано к заказу или лежит в разделе «разобрать вручную».
Заказчику отдал исходники, админку с историей и выводом, инструкцию: как сменить курсовой источник, порог подтверждений и адреса вывода.
После приёмки добавил напоминание в чат за три минуты до конца инвойса - люди уходили на биржу и возвращались уже к просроченной сумме.
Скриншоты экранов оплаты и админки приложены к работе.