Интеграция платёжного шлюза — это не просто вызов нескольких API-методов. Это полноценная инженерная задача, требующая тщательного внимания к безопасности, обработке ошибок, идемпотентности операций и надёжной доставке событий. Наша веб-платформа ежемесячно обслуживает тысячи активных пользователей, и с расширением продуктовых направлений нам необходим standalone-модуль, который можно встроить в любой компонент системы без технического долга и уязвимостей. Желателен опыт работы с требованиями PCI-DSS и практиками безопасного программирования по OWASP.
Модуль обязан охватывать полный жизненный цикл транзакции: инициацию платежа через API провайдера, получение и криптографическую верификацию вебхуков по HMAC-подписи, переход в режим поллинга статуса при недоставке вебхуков, обработку полных и частичных возвратов, а также ведение неизменяемого журнала каждой операции для внутреннего комплаенса и внешних аудитов. Ожидаем PSR-4-структуру, грамотную обработку исключений с логикой повторных попыток и юнит-тесты на всех критических путях. Документация должна быть достаточно подробной, чтобы разработчик среднего уровня мог самостоятельно поддерживать и развивать модуль.
Требования: — PHP 7.4+ совместимый модуль с PSR-4 автозагрузкой — Вебхук-эндпоинт с HMAC-верификацией и защитой от повторных атак — Поллинг статуса транзакций при сбоях доставки вебхука — Возврат средств: полный и частичный через API провайдера — Журнал транзакций с поиском, фильтрацией и CSV-экспортом — Юнит-тесты с покрытием не менее 80% критической логики
Результат: PSR-4-модуль, OpenAPI 3.0 спецификация, пошаговое руководство с примерами кода.