PHP SDK

Official PHP and Laravel integration guide for the Malipo Payment Gateway.

Installation

composer require malipo/malipo-php

Quickstart

<?php
require 'vendor/autoload.php';

use Malipo\Malipo;

$malipo = new Malipo(getenv('MALIPO_SECRET_KEY'));

try {
    $charge = $malipo->charges->create([
        "amount" => 10,
        "currency" => "USD",
        "phone" => "+243810000000",
        "network" => "VODACOM_MPESA",
        "description" => "Order #123"
    ], [
        'idempotencyKey' => 'unique_order_id_123'
    ]);

    echo "Charge initiated: " . $charge['id'];
} catch (\Exception $e) {
    echo "Error: " . $e->getMessage();
}

Check Balance

$balance = $malipo->balance->retrieve();
echo "Available: " . $balance['available'][0]['amount'];

Error Handling

use Malipo\Exceptions\MalipoException;

try {
    $malipo->charges->create(['amount' => -1]);
} catch (MalipoException $e) {
    echo "API Error: " . $e->getMessage();
    echo "Code: " . $e->getStatusCode();
}

Webhook Handler

<?php
require 'vendor/autoload.php';

use Malipo\Malipo;

$malipo = new Malipo(getenv('MALIPO_SECRET_KEY'));

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'];

try {
    $event = $malipo->webhooks->constructEvent(
        $payload,
        $signature,
        getenv('MALIPO_WEBHOOK_SECRET')
    );

    if ($event['type'] === 'charge.succeeded') {
        $charge = $event['data']['object'];
        // Process successful payment
    }
} catch (\Exception $e) {
    http_response_code(400);
    echo $e->getMessage();
}