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

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

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

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

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