PHP中的支付网关集成

支付网关集成不仅仅是调用几个API方法。这是一个全面的工程任务，需要仔细关注安全性、错误处理、操作幂等性和可靠的事件传递。我们的网络平台每月服务超过5000名活跃用户，随着我们产品的扩展，我们需要一个独立的模块，可以嵌入系统的任何组件中，而不会产生技术债务和漏洞。具有符合PCI-DSS要求和根据OWASP的安全编码实践的经验是可取的。

该模块必须覆盖完整的交易生命周期：通过提供者API发起支付，接收并使用HMAC签名进行加密验证的webhooks，如果webhooks未能送达则切换到状态轮询模式，处理全额和部分退款，并维护每个操作的不可变日志，以便于内部合规和外部审计。我们期望PSR-4结构，适当的异常处理和重试逻辑，以及所有关键路径的单元测试。文档应详细到中级开发人员可以独立维护和开发该模块。

要求：
— 兼容PHP 7.4+的模块，具有PSR-4自动加载
— 具有HMAC验证和防重放攻击保护的Webhook端点
— 当webhook交付失败时进行交易状态轮询
— 退款：通过提供者API进行全额和部分退款
— 具有搜索、过滤和CSV导出的交易日志
— 覆盖至少80%关键逻辑的单元测试

结果：PSR-4模块，OpenAPI 3.0规范，带有代码示例的逐步指南。