Descrição do projeto
TraduzidoO módulo deve cobrir todo o ciclo de vida do pagamento: iniciando transações via a API do provedor, recebendo e verificando criptograficamente callbacks de webhook usando assinaturas HMAC, voltando para a consulta de status quando os webhooks falham em entregar, processando reembolsos totais e parciais, e mantendo um registro de auditoria imutável que satisfaça tanto nossa equipe interna de conformidade quanto quaisquer auditorias de provedores de pagamento externos. Esperamos uma estrutura PSR-4 limpa, tratamento adequado de exceções com lógica de repetição e testes unitários cobrindo todos os caminhos críticos. A documentação deve ser detalhada o suficiente para que um desenvolvedor de nível médio possa integrar e manter o módulo de forma independente.
Requisitos principais:
— Módulo compatível com PHP 7.4+ com autoloading PSR-4
— Endpoint de Webhook com verificação de assinatura HMAC e proteção contra ataques de repetição
— Consulta de status como fallback quando a entrega do webhook falha
— Processamento de reembolsos totais e parciais via API do provedor
— Visualização do histórico de transações do administrador com pesquisa, filtragem e exportação CSV
— Testes unitários com cobertura mínima de 80% da lógica de transação principal
Entregáveis: módulo PHP autônomo, especificação OpenAPI 3.0, guia de integração com exemplos de código.