Integración de Pasarela de Pago en PHP

La integración de la pasarela de pago no es simplemente una cuestión de llamar a algunos métodos de API. Es una tarea de ingeniería completa que requiere atención cuidadosa a la seguridad, manejo de errores, idempotencia de operaciones y entrega confiable de eventos. Nuestra plataforma web sirve a más de 5000 usuarios activos mensuales, y a medida que expandimos nuestra oferta de productos, necesitamos un módulo independiente que pueda ser integrado en cualquier componente del sistema sin deuda técnica y vulnerabilidades. Se desea experiencia con los requisitos de PCI-DSS y prácticas de codificación segura según OWASP.

El módulo debe cubrir el ciclo de vida completo de la transacción: iniciar el pago a través de la API del proveedor, recibir y verificar criptográficamente los webhooks utilizando firmas HMAC, cambiar al modo de sondeo de estado si los webhooks no se entregan, procesar reembolsos completos y parciales, y mantener un registro inmutable de cada operación para el cumplimiento interno y auditorías externas. Esperamos una estructura PSR-4, manejo adecuado de excepciones con lógica de reintento y pruebas unitarias en todos los caminos críticos. La documentación debe ser lo suficientemente detallada para que un desarrollador de nivel medio pueda mantener y desarrollar el módulo de forma independiente.

Requisitos:
— Módulo compatible con PHP 7.4+ con autoloading PSR-4
— Endpoint de webhook con verificación HMAC y protección contra ataques de repetición
— Sondeo de estado de transacción cuando falla la entrega del webhook
— Reembolsos: completos y parciales a través de la API del proveedor
— Registro de transacciones con búsqueda, filtrado y exportación a CSV
— Pruebas unitarias con cobertura de al menos el 80% de la lógica crítica

Resultado: módulo PSR-4, especificación OpenAPI 3.0, guía paso a paso con ejemplos de código.