Надійна інтеграція платіжного шлюзу вимагає набагато більше, ніж просто виклики кількох API-кінцевих точок — це вимагає ретельної уваги до безпеки, ідемпотентності, відновлення після помилок та граничних випадків, які можуть вплинути на кожну окрему транзакцію, яку обробляє ваш бізнес. Наша веб-платформа обслуговує тисячі активних користувачів щомісяця, і коли ми розширюємо наш каталог продуктів, нам потрібен автономний, добре архітектований PHP модуль, який можна вбудувати в будь-яку підсистему без накопичення технічного боргу або відкриття брешей в безпеці. Знайомство з усвідомленням PCI-DSS, напрямками безпечного кодування OWASP та шаблонами надійності вебхуків є суттєвим для цього проекту.
Модуль повинен охоплювати весь цикл платежу: ініціювання транзакцій через API провайдера, отримання та криптографічне верифікацію зворотних викликів вебхуків за допомогою HMAC підписів, повернення до опитування стану, коли доставка вебхуків не вдається, обробка повних та часткових повернень, і ведення незмінного журналу аудиту, який задовольняє як нашу внутрішню команду відповідності, так і будь-які зовнішні аудити платіжного провайдера. Ми очікуємо чистої структури PSR-4, належної обробки винятків з логікою повторних спроб та модульних тестів, які охоплюють всі критичні шляхи. Документація повинна бути достатньо докладною, щоб розробник середнього рівня міг самостійно підключити та обслуговувати модуль.
Основні вимоги: — Модуль сумісний з PHP 7.4+ з автозавантаженням PSR-4 — Кінцева точка вебхука з верифікацією підпису HMAC та захистом від атак відтворення — Резервне опитування стану, коли доставка вебхука не вдається — Обробка повних та часткових повернень через API провайдера — Перегляд історії транзакцій адміністратора з пошуком, фільтруванням та експортом CSV — Модульні тести з мінімум 80% покриттям логіки основних транзакцій