Integração de Gateway de Pagamento em PHP

A integração de gateway de pagamento não é simplesmente uma questão de chamar alguns métodos de API. É uma tarefa de engenharia completa que requer atenção cuidadosa à segurança, tratamento de erros, idempotência de operação e entrega confiável de eventos. Nossa plataforma web atende mais de 5000 usuários ativos mensalmente, e à medida que expandimos nossas ofertas de produtos, precisamos de um módulo autônomo que possa ser incorporado em qualquer componente do sistema sem dívida técnica e vulnerabilidades. Experiência com requisitos PCI-DSS e práticas de codificação segura de acordo com OWASP é desejável.

O módulo deve cobrir todo o ciclo de vida da transação: iniciando o pagamento através da API do provedor, recebendo e verificando criptograficamente webhooks usando assinaturas HMAC, mudando para o modo de polling de status se os webhooks falharem na entrega, processando reembolsos totais e parciais, e mantendo um registro imutável de cada operação para conformidade interna e auditorias externas. Esperamos uma estrutura PSR-4, tratamento adequado de exceções com lógica de repetição e testes unitários em todos os caminhos críticos. A documentação deve ser detalhada o suficiente para que um desenvolvedor de nível médio possa manter e desenvolver o módulo de forma independente.

Requisitos:
— Módulo compatível com PHP 7.4+ com autoloading PSR-4
— Endpoint de webhook com verificação HMAC e proteção contra ataques de repetição
— Polling de status de transação quando a entrega do webhook falha
— Reembolsos: totais e parciais através da API do provedor
— Registro de transações com pesquisa, filtragem e exportação CSV
— Testes unitários com cobertura de pelo menos 80% da lógica crítica

Resultado: Módulo PSR-4, especificação OpenAPI 3.0, guia passo a passo com exemplos de código.