Download the PHP package grupofixit/mpesa without Composer

Grupo FixIT M-Pesa PHP SDK (grupofixit/mpesa)

SDK oficial e independente de framework do Grupo FixIT Limitada para integração segura e de alta confiabilidade com a API Vodacom M-Pesa Moçambique (api.sandbox.vm.co.mz e api.vm.co.mz).

🌟 Características Principais

• PHP 8.3+ Nativo: Desenvolvido com declare(strict_types=1), classes readonly, tipos estritos e Enums nativos.
• Conformidade Estrita com Padrões PSR:
  • PSR-18 (HTTP Client) e PSR-17 (HTTP Factory)
  • PSR-7 (HTTP Messages)
  • PSR-3 (Logger com mascaramento automático de credenciais)
  • PSR-16 (Simple Cache para armazenamento e reutilização de tokens)
• Segurança de Nível Bancário:
  • TLS Sempre Verificado: Impossível desativar a verificação de certificados SSL/TLS por configuração.
  • Isolamento de PIN: O sistema nunca solicita, manipula ou armazena o PIN do cliente (autorização via USSD Push no telemóvel do utilizador).
  • Redação Automática de Segredos: apiKey, securityCredential, tokens Bearer e números de telefone são automaticamente ofuscados em logs e rastreios (Redactor).
• Consistência Financeira:
  • Zero Retries Automáticos: Falhas de rede ou timeouts em movimentações de fundos lançam OutcomeUnknownException com a referência única para resolução obrigatória via Transaction Status Query.
• Ferramentas de Teste Integradas:
  • Inclui FakeMpesa e FakeTransport prontos para testes unitários nas suas aplicações sem necessidade de chamadas externas de rede.

📋 Requisitos

• PHP: ^8.3
• Extensões: ext-openssl, ext-json
• Implementação HTTP PSR-18/PSR-17 (ex.: guzzlehttp/guzzle e guzzlehttp/psr7)

🚀 Instalação

Instale a biblioteca via Composer:

⚙️ Configuração Inicial

💡 Exemplos de Uso

1. Cobrança a Cliente (C2B Single Stage)

Dispara um pedido de pagamento via USSD Push para o telemóvel do cliente (janela de 60 segundos para inserção do PIN).

2. Consulta de Estado de Transação (Status Query)

Utilizado para confirmar o estado final de qualquer transação (resposta oficial da Vodacom).

3. Consulta de Nome do Cliente (Customer Name Query)

Permite obter o nome ofuscado do titular antes de efetuar a cobrança para confirmação visual do utilizador.

4. Pagamento a Cliente (B2C) e Entre Empresas (B2B)

5. Estorno / Reembolso (Reversal)

Suporta estorno total ou parcial de pagamentos concluídos.

6. Processamento de Webhooks (Callback)

Parser rigoroso para callbacks assíncronos enviados pelos servidores da Vodacom.

🧪 Testes Unitários com FakeMpesa

Para testar as aplicações consumidoras sem disparar chamadas de rede à Vodacom:

🛡️ Segurança

Se descobrir alguma vulnerabilidade de segurança, envie um relatório confidencial para [email protected].

📄 Licença

Proprietária. © Grupo FixIT Limitada. Todos os direitos reservados.