支付网关集成 — PHP开发者

构建可靠的支付网关集成远不止于调用几个API端点 — 它需要对安全性、幂等性、错误恢复以及可能影响您业务处理的每一笔交易的边缘情况给予细致关注。我们的网络平台每月服务数千名活跃用户，随着我们扩展产品目录，我们需要一个独立的、架构良好的PHP模块，可以嵌入到任何子系统中，而不会引入技术债务或打开安全漏洞。熟悉PCI-DSS意识、OWASP安全编码指南和Webhook可靠性模式对这个项目至关重要。

该模块必须覆盖完整的支付生命周期：通过提供者API发起交易，接收并使用HMAC签名加密验证Webhook回调，当Webhook未能交付时回退到状态轮询，处理全额和部分退款，并维护一个不可变的审计跟踪，以满足我们内部合规团队和任何外部支付提供商的审计要求。我们期望干净的PSR-4结构，适当的异常处理和重试逻辑，以及覆盖所有关键路径的单元测试。文档应详尽到中级开发者可以独立上手和维护该模块。

核心要求：
— 兼容PHP 7.4+的模块，支持PSR-4自动加载
— 带有HMAC签名验证和重放攻击保护的Webhook端点
— 当Webhook交付失败时的状态轮询回退
— 通过提供者API处理全额和部分退款
— 带有搜索、过滤和CSV导出的管理员交易历史视图
— 核心交易逻辑的单元测试覆盖率至少为80%

交付物：独立的PHP模块，OpenAPI 3.0规范，带有代码示例的集成指南。