How to Deploy a Captive Portal with M-Pesa Vouchers (Step-by-Step)

// Sample M-Pesa API Configuration (PHP)
class MpesaConfig {
    const CONSUMER_KEY = 'your_consumer_key_here';
    const CONSUMER_SECRET = 'your_consumer_secret_here';
    const ENVIRONMENT = 'sandbox'; // Change to 'production' for live
    const SHORTCODE = 'your_till_number';
    const PASSKEY = 'your_lipa_na_mpesa_passkey';
    const CALLBACK_URL = 'https://yoursite.com/api/mpesa/callback';
    
    // Test credentials for sandbox
    const TEST_SHORTCODE = '174379';
    const TEST_PASSKEY = 'bfb279f9aa9bdbcf158e97dd71a467cd2e0c893059b10f78e6b72ada1ed2c919';
}

// Payment initiation function
function initiateMpesaPayment($amount, $phone, $voucher_code) {
    $timestamp = date('YmdHis');
    $password = base64_encode(MpesaConfig::SHORTCODE . MpesaConfig::PASSKEY . $timestamp);
    
    $curl_post_data = [
        'BusinessShortCode' => MpesaConfig::SHORTCODE,
        'Password' => $password,
        'Timestamp' => $timestamp,
        'TransactionType' => 'CustomerPayBillOnline',
        'Amount' => $amount,
        'PartyA' => $phone,
        'PartyB' => MpesaConfig::SHORTCODE,
        'PhoneNumber' => $phone,
        'CallBackURL' => MpesaConfig::CALLBACK_URL,
        'AccountReference' => $voucher_code,
        'TransactionDesc' => 'Wi-Fi Access Voucher'
    ];
    
    return sendMpesaRequest('mpesa/stkpush/v1/processrequest', $curl_post_data);
}