Інтеграція платіжного шлюзу на PHP

Інтеграція платіжного шлюзу — це повноцінна інженерна задача, яка потребує уваги до безпеки, обробки помилок, ідемпотентності операцій і надійної доставки подій. Наша веб-платформа щомісяця обслуговує тисячі активних користувачів, і з розширенням продуктових напрямків нам потрібен standalone-модуль, який можна вбудувати в будь-який компонент системи без технічного боргу і вразливостей. Бажаний досвід роботи з вимогами PCI-DSS та безпечного програмування за OWASP.

Модуль повинен охоплювати повний життєвий цикл транзакції: ініціацію платежу через API провайдера, отримання та криптографічну верифікацію вебхуків за HMAC-підписом, перехід у режим поллінгу статусу при недоставці вебхуків, обробку повних і часткових повернень, а також ведення незмінного журналу кожної операції для внутрішнього комплаєнсу і зовнішніх аудитів. Очікуємо PSR-4-структуру, грамотну обробку винятків з логікою повторних спроб та юніт-тести на всіх критичних шляхах. Документація має бути достатньо детальною, щоб розробник середнього рівня міг самостійно підтримувати та розвивати модуль.

Вимоги:
— PHP 7.4+ сумісний модуль з PSR-4 автозавантаженням
— Вебхук-ендпоінт з HMAC-верифікацією та захистом від replay-атак
— Поллінг статусу транзакцій при збоях доставки вебхука
— Повне та часткове повернення коштів через API провайдера
— Журнал транзакцій з пошуком, фільтрацією та CSV-експортом
— Юніт-тести з покриттям не менше 80% критичної логіки

Результат: PSR-4-модуль, специфікація OpenAPI 3.0, покрокове керівництво з прикладами коду.