Integrazione del Gateway di Pagamento in PHP

L'integrazione del gateway di pagamento non è semplicemente una questione di chiamare alcuni metodi API. È un compito ingegneristico a tutti gli effetti che richiede attenzione particolare alla sicurezza, gestione degli errori, idempotenza delle operazioni e consegna affidabile degli eventi. La nostra piattaforma web serve più di 5000 utenti attivi mensilmente e, mentre espandiamo la nostra offerta di prodotti, abbiamo bisogno di un modulo autonomo che possa essere integrato in qualsiasi componente del sistema senza debito tecnico e vulnerabilità. È desiderabile avere esperienza con i requisiti PCI-DSS e pratiche di codifica sicura secondo OWASP.

Il modulo deve coprire l'intero ciclo di vita della transazione: avvio del pagamento tramite l'API del fornitore, ricezione e verifica crittografica dei webhook utilizzando firme HMAC, passaggio alla modalità di polling dello stato se i webhook non vengono consegnati, elaborazione di rimborsi totali e parziali e mantenimento di un registro immutabile di ogni operazione per la conformità interna e audit esterni. Ci aspettiamo una struttura PSR-4, una corretta gestione delle eccezioni con logica di ripetizione e test unitari su tutti i percorsi critici. La documentazione dovrebbe essere sufficientemente dettagliata affinché uno sviluppatore di livello medio possa mantenere e sviluppare il modulo in modo indipendente.

Requisiti:
— Modulo compatibile con PHP 7.4+ con autoloading PSR-4
— Endpoint webhook con verifica HMAC e protezione contro attacchi di replay
— Polling dello stato della transazione quando la consegna del webhook fallisce
— Rimborsi: totali e parziali tramite l'API del fornitore
— Registro delle transazioni con ricerca, filtraggio ed esportazione CSV
— Test unitari con copertura di almeno l'80% della logica critica

Risultato: modulo PSR-4, specifica OpenAPI 3.0, guida passo-passo con esempi di codice.