Операционный чек-лист продавца криптоплатежей

До запуска

Делайте один раз и повторяйте после любого изменения сервера.

• API-ключ только на сервере, в переменной окружения или хранилище секретов, но не во фронтенд-коде и не в репозитории.
• Callback URL сохранён, публичен и работает по HTTPS, доступен снаружи вашей сети.
• Обработчик webhook отвечает ровно HTTP 200, быстро, и безопасен при двойном запуске. Любой другой статус, таймаут или редирект считаются неудачной доставкой. См. как защитить webhook криптоплатежей.
• Тестовый платёж проходит от начала до конца. Оплатите небольшую настоящую сумму, увидьте приход webhook и переход заказа в оплаченный. Sandbox пока нет, поэтому берите небольшие реальные суммы.
• Повтор работает. Один раз заставьте точку вернуть ошибку и убедитесь, что Qvard повторяет (пять попыток примерно за шесть минут) без двойного выполнения.
• Вывод работает. Выведите небольшую сумму на свой кошелёк. Он стоит только сетевую комиссию.
• Правила записаны: что делать с неполным платежом, как вы возвращаете деньги и кто отвечает клиентам.

Каждый день

Несколько минут, лучше в одно и то же время.

• Неоплаченные заказы за окном курса. Курс на странице оплаты фиксируется на один час. Посмотрите заказы, которые ждут дольше: их бросили или пропустили уведомление.
• Неполные платежи. Платёж со статусом partial не отправляет webhook о завершении. Проверяйте такие платежи в кабинете, держите заказ в ожидании и свяжитесь с клиентом. См. недоплата в USDT: что делать.
• Ошибки на точке webhook. Серия неудачных запросов или ответов 401 значит сломанную точку или несовпадение ключа. Настройте оповещение, а не находите это в конце дня.
• Итог за день. Сравните заказы, которые вы пометили оплаченными, с платежами в кабинете. В публичном API нет маршрута со списком платежей, так что это сравнение с вашим журналом webhook. См. сверка криптоплатежей для продавца.

Каждую неделю

• Пропущенные уведомления. Если кабинет показывает завершённый платёж, а ваша система заказов нет, отправьте уведомление повторно из кабинета и дайте идемпотентному обработчику применить его.
• Закономерности в поддержке. Посчитайте обращения про неверные сети, неполные платежи и «я заплатил, ничего не произошло». Если что-то повторяется, исправьте формулировку на чекауте или странице заказа, а не каждое обращение.
• Возвраты. Проверьте, что каждый отправленный возврат записан на исходный заказ и ушёл на адрес и сеть, которые подтвердил клиент.
• Балансы по активу и сети. Платежи в разных сетях накапливаются отдельно. Посмотрите, что где лежит, прежде чем решать, что выводить.
• Остатки и истечение. Если вы резервируете товар под неоплаченные заказы, убедитесь, что истёкшие заказы его освобождают.

Каждый месяц

• Полная сверка. Сопоставьте заказы месяца, журнал webhook и платежи кабинета и объясните каждое расхождение. Фиксируйте выручку в долларах по стоимости заказа, а комиссию и комиссии вывода записывайте отдельными строками.
• Пересмотр выводов. Абонентской платы нет; комиссия индивидуальна для проекта и по странице тарифов начинается с 1%, а может быть снижена до 0,1%. Вывод стоит только сетевую комиссию, обычно фиксированную за перевод, поэтому выводите разумными суммами, а не множеством мелких. См. сетевые комиссии в криптоплатежах.
• Ротация и аудит доступа. Проверьте, кто видит API-ключ и кабинет, и замените ключ, если ушёл кто-то из имевших его или вы подозреваете утечку.
• Перечитайте текст для клиентов. Указаны ли на чекауте принимаемые активы и сети, пометка о комиссиях и правило возврата? Это всё ещё верно?
• Сверьтесь с бухгалтером. Налогообложение и учёт криптопоступлений зависят от вашей страны; пересматривайте практику регулярно.

Когда что-то выглядит неправильно

Короткий сценарий для частых случаев.

• Клиент говорит, что заплатил, а заказ не оплачен. Посмотрите платёж в кабинете. Если он завершён, отправьте уведомление повторно. Если partial, попросите доплатить. Если его нет, запросите данные транзакции и сеть, которой он пользовался.
• Неверная сеть. Средства придут не так, как ожидалось, и потребуют ручного разбора. Держите контакт поддержки на виду на пути оплаты.
• Оплаченный заказ выполнен дважды. Обработчик не идемпотентен. Сделайте обновление условным («оплачен, только если ещё не оплачен») одним запросом к базе.
• Webhook перестал приходить. Проверьте точку снаружи вашей сети, посмотрите код ответа в журнале доступа и поищите файрвол, редирект или медленный обработчик. См. повторы webhook в платёжных системах.
• Вы не уверены, что делает API. Справочник это API для криптоплатежей.

Держите этот список там, где его видит вся команда, и запишите, кто отвечает за каждую строку.

FAQ