carsaimz/mpesa-api

API PHP para integração com M-PESA de Moçambique. # Carsai Mozambique | mpesa-api **English | Português** API PHP para integração com M-PESA de Moçambique. ## 📦 Instalação ### Via Composer (Recomendado) ```bash composer require carsaimz/mpesa-api ``` Instalação Manual 1. Faça download dos arquivos 2. Inclua o autoloader no seu projeto: ```php require_once 'caminho/para/autoload.php'; ``` ⚙️ Configuração Obtenha suas credenciais em developer.mpesa.vm.co.mz ```php use carsaimz\Mpesa; $mpesa = Mpesa::init( $api_key, // API Key do portal $public_key, // Public Key do portal "development" // "development" (sandbox) ou "production" (produção) ); ``` 🚀 Operações Suportadas 1. C2B (Cliente → Negócio) Pagamento do cliente para o negócio. ```php $response = $mpesa->c2b([ "value" => 10, // Valor da transação "client_number" => "258840000000", // Número do cliente (formato: 258XXXXXXXXX) "agent_id" => 171717, // Código do agente/fornecedor "transaction_reference" => 1234567, // Referência da transação (única) "third_party_reference" => 33333 // Referência de terceiro ]); print_r($response); ``` 2. B2C (Negócio → Cliente) Pagamento do negócio para o cliente. ```php $response = $mpesa->b2c([ "value" => 10, "client_number" => "258840000000", "agent_id" => 171717, "transaction_reference" => 1234567, "third_party_reference" => 33333 ]); print_r($response); ``` 3. B2B (Negócio → Negócio) Transferência entre empresas. ```php $response = $mpesa->b2b([ "value" => 10, "agent_id" => 171717, // Código do remetente "agent_receiver_id" => 979797, // Código do destinatário "transaction_reference" => 1234567, "third_party_reference" => 33333 ]); print_r($response); ``` 4. Reversão Estorno de uma transação. ```php $response = $mpesa->reversal([ "value" => 10, // Valor a reverter "security_credential" => "", // Credencial de segurança (gerada) "indicator_identifier" => "", …