Платежи и подписки
Интеграции платёжных провайдеров и доступных интерфейсов Kaspi, повторяющиеся списания, привязка карт, вебхуки, возвраты и сверка. Разбираем, где именно ломается оплата, и приводим денежный контур в состояние, за которое не страшно отвечать.
01Симптомы
Ниже — типичные ситуации, с которых начинается предметный разговор.
02Охват
03Результат
Состав зависит от задачи. Ниже — типичные результаты, которые можно проверить, передать команде и использовать без постоянной зависимости от подрядчика.
Диаграмма состояний платежа и подписки, перечень внешних событий и правил перехода. Документ, по которому команда понимает поведение системы без чтения кода.
Код в вашем репозитории, в вашем стиле, с покрытием тестами критичных ветвей — ретраев, идемпотентности и обработки повторных вебхуков.
Журнал переходов, читаемые причины отказов и отчёт сверки, чтобы поддержка могла разобраться в конкретном платеже без обращения к разработчику.
Список сценариев, которые остались не покрыты, и что произойдёт, если они случатся. Честно — включая то, что мы не рекомендуем чинить прямо сейчас.
04Ход работы
01
Диагностика
Читаем код оплаты, логи и выгрузки провайдера. Ищем расхождения между тем, что система думает о платеже, и тем, что произошло на самом деле.
02
Модель состояний
Фиксируем, в каких состояниях бывает платёж и подписка, какие события их меняют и что считается недопустимым переходом.
03
Идемпотентность и ретраи
Повторная доставка события провайдера не приводит к повторному начислению или заказу. Неуспешное списание повторяется по заданным правилам и с ограничением числа попыток, а не по случайности.
04
Сверка
Ежедневное сопоставление с реестром провайдера. Расхождение становится видимым событием, а не находкой бухгалтера в конце месяца.
05
Передача
Документация, разбор с командой и поддержка на период стабилизации.
05Разборы
Ход рассуждения, архитектурные решения и нештатные ситуации по этому направлению.
Обобщённый сценарий подписочного сервиса, который теряет продления на технических отказах. Разбираем машину состояний, идемпотентные вебхуки, управляемые ретраи и ежедневную сверку с провайдером.
06Форматы
Конкретный объём и стоимость определяем после знакомства с системой. Первый этап можно заказать отдельно и использовать без продолжения работы с нами.
Короткий формат для входа. Разбираем текущую реализацию, находим места потери денег и приоритизируем исправления. На выходе — отчёт и план, которым можно пользоваться без нашего дальнейшего участия.
Полный объём: от схемы состояний до сверки и аналитики. Подходит, когда подписочная модель запускается с нуля или переписывается.
Работаем внутри вашего процесса над конкретной подсистемой. Подходит, когда команда есть, но платёжной экспертизы не хватает.
07Вопросы
Принцип работы у большинства провайдеров общий: создание платежа, редирект или виджет, вебхук о результате, токен для повторных списаний. Различия в деталях API изучаются по документации на старте проекта. Если провайдер новый для нас, мы говорим об этом прямо и закладываем время на изучение.
Да, и это одна из типовых задач. Провайдеры прячутся за общим интерфейсом, бизнес-логика не знает, кто именно проводит платёж. Переключение становится настройкой, а не переписыванием кода. Важно учесть, что токены карт не переносятся между провайдерами — это ограничение платёжной индустрии, а не архитектуры.
Сначала тестовая среда провайдера, затем поэтапный вывод с возможностью отката. Изменения в денежном контуре не выкатываются целиком. Отдельно проговариваем, какие операции необратимы и как мы их страхуем.
Нет, и никто не может. Часть отказов приходит от банка-эмитента: недостаточно средств, лимиты, блокировки. Инженерная задача — не потерять те платежи, которые могли пройти, и корректно обработать те, которые пройти не могли. Разницу между этими группами можно измерить, и именно с ней мы работаем.
Для диагностики достаточно кода и обезличенных логов. Доступ к боевой среде обсуждается отдельно и оформляется по вашим правилам безопасности.
Опишите текущее состояние системы и желаемый результат. Определим, относится ли задача к направлению «Платежи и подписки» и с какого шага разумно начать.