Между «интеграция готова» и «можно пускать людей» лежит десяток проверок, которые обычно делают уже после первых потерянных заказов. Список ниже собран из типичных провалов первых недель: не пришёл вебхук, доступ выдался дважды, тестовый ключ уехал в продакшен, письмо ушло не тому.
Пройдите его перед запуском — это несколько часов работы против недели разбирательств.
Деньги и условия
- Итоговая ставка подтверждена письменно: комиссия приёма, условия вывода, минимальные и максимальные суммы.
- Проверено, какая сумма реально доходит до баланса при тестовом платеже на круглую сумму.
- Понятно, когда и как выводятся средства: срок, комиссия, ограничение по частоте.
- Название продавца в выписке покупателя проверено и узнаваемо.
Последний пункт откладывают чаще всего, а он напрямую влияет на споры: незнакомая строка в выписке приводит покупателя не к вам, а в банк.
Техническая часть
- Ключи разделены: тестовые и боевые лежат в разных местах, боевые — только в переменных окружения.
- Вебхук принимает уведомления по HTTPS, проверяет подпись и отвечает быстро.
- Повторная доставка обрабатывается: одно и то же событие, пришедшее дважды, не выдаёт товар дважды.
- Создание платежа идемпотентно: повторный запрос с тем же ключом не создаёт второй счёт.
- Статус заказа берётся из серверного уведомления, а не из редиректа браузера.
- Есть запасной путь: если уведомление не пришло, статус можно запросить самому.
Проверять это нужно не чтением кода, а действием: отправьте себе то же уведомление дважды и убедитесь, что доступ выдан один раз.
Сценарии, которые надо прогнать руками
К этим трём добавьте истечение срока счёта, оплату с телефона в мобильной сети и возврат средств. Возврат особенно важно прогнать заранее: в момент, когда он понадобится, разбираться будет некогда.
Тексты и письма
- Кнопка называет действие и сумму, а не «продолжить».
- Сообщения об ошибках написаны словами покупателя и подсказывают следующий шаг.
- Письмо после оплаты содержит номер заказа, сумму, доступ и контакт поддержки.
- Для подписки указаны периодичность, дата следующего списания и способ отмены.
- Условия оплаты и правила возврата опубликованы и доступны со страницы оплаты.
Наблюдение и реакция
После запуска важно быстро узнавать о проблемах, а не читать о них в обращениях.
- Настроено уведомление о всплеске отказов и о падении доли успешных платежей.
- Видно, если вебхуки перестали приходить: тишина — это тоже событие.
- Двойная оплата по одному заказу порождает оповещение сама.
- Есть журнал: по идентификатору платежа можно восстановить всю цепочку.
Минимально достаточно одного канала в мессенджере, куда падают эти сигналы. Отсутствие мониторинга обнаруживается всегда одинаково — через сообщение клиента, который заплатил и ничего не получил.
Люди и процессы
Техника без процесса не работает. Перед запуском договоритесь, кто отвечает на обращения про платежи, где смотрит статус, кто имеет право делать возврат и что говорить, если деньги списались, а доступ не пришёл.
Короткая инструкция на одну страницу с типовыми ситуациями и точными формулировками сэкономит больше времени, чем любая автоматизация: первые недели поддержка отвечает на одни и те же пять вопросов.
Доступы и разграничение прав
Отдельный блок, про который вспоминают после первого неприятного случая. Ключи от платёжного API — это доступ к деньгам, и обращаться с ними нужно соответственно.
Перед запуском проверьте: боевые ключи не лежат в репозитории и не пересылались в переписке; у каждого сотрудника свой вход в личный кабинет, а не общий логин на всех; право на вывод средств есть только у тех, кому оно действительно нужно; включено подтверждение критичных операций вторым фактором; изменение реквизитов вывода фиксируется в журнале и заметно.
Последний пункт стоит отработать заранее: подмена реквизитов — самый частый способ увести деньги у проекта, где доступы раздали быстро и всем сразу. Journal с записью «кто и когда менял кошелёк» превращает такой инцидент из детектива в одну строку поиска.
Что зафиксировать письменно
Договорённости, которые живут только в переписке, теряются вместе с менеджером. Перед запуском полезно свести в один документ: ставку и условия вывода, лимиты, порядок возвратов, сроки ответа поддержки провайдера, контакты для срочных случаев и порядок действий при массовом сбое.
Этот же документ пригодится при подключении второго провайдера: сравнивать условия проще, когда собственные требования уже сформулированы, а не собираются заново под каждое коммерческое предложение.
Первая неделя после запуска
Не считайте запуск завершённым в день включения. В первую неделю ежедневно смотрите три вещи: долю успешных платежей, причины отказов и обращения в поддержку. Именно там всплывают сценарии, которых не было в тестах, — чужие банки, старые браузеры, неожиданные суммы.
И оставьте себе право быстро откатить изменения. Возможность вернуть предыдущую версию платёжного шага за минуты стоит дороже, чем любые предварительные тесты.