PHP SDK

Le SDK PHP officiel pour intégrer SahelPay dans vos applications PHP et Laravel.

Installation

composer require sahelpay/sahelpay-php

En attendant la publication sur Packagist, clonez le repo GitHub :

git clone https://github.com/dione24/sahelpay-sdks.git

Configuration

use SahelPay\SahelPay;

$sahelpay = new SahelPay('sk_test_xxx');

Le mode sandbox utilise la même base URL API (https://api.sahelpay.ml) avec une clé sk_test_....

Laravel

// config/services.php
'sahelpay' => [
    'secret_key' => env('SAHELPAY_SECRET_KEY'),
    'webhook_secret' => env('SAHELPAY_WEBHOOK_SECRET'),
],

Créer un lien de paiement

$link = $sahelpay->paymentLinks->create([
    'title' => 'Commande #123',
    'price' => 5000,
    'redirect_url' => 'https://votre-site.com/checkout/return',
]);

// Rediriger le client
header('Location: ' . $link->url);
exit;

Tester sans appel opérateur

L’option mock active le simulateur SahelPay : aucun appel opérateur, et le statut final est piloté par le montant (4000 réussi, 4001 échoué, 4002 en attente, 4003 erreur opérateur). À ne pas confondre avec sandbox, qui appelle bien l’environnement de test de l’opérateur.

$payment = $sahelpay->payments->initiate([
    'amount' => 4000,
    'provider' => 'ORANGE_MONEY',
    'customer_phone' => '+22370123456',
    'return_url' => 'https://votre-site.com/checkout/return',
    'mock' => true,
]);

$status = $sahelpay->payments->verify($payment->id);
echo $status->status; // SUCCESS

$sahelpay->webhooks->test(); // envoie webhook.test vers votre endpoint configuré

Vérifier le statut

$payment = $sahelpay->payments->verify('txn_abc123');

echo $payment->status; // 'PENDING', 'SUCCESS', 'FAILED'
echo $payment->amount;

Vérifier un webhook

// Dans votre controller webhook
$rawBody = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_SAHELPAY_SIGNATURE'] ?? '';

$isValid = $sahelpay->webhooks->verify($rawBody, $signature);

if (!$isValid) {
    http_response_code(401);
    echo json_encode(['error' => 'Invalid signature']);
    exit;
}

$event = json_decode($rawBody, true);

if ($event['event'] === 'payment.success') {
    // Mettre à jour la commande
}

http_response_code(200);
echo json_encode(['received' => true]);

Laravel Controller

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use SahelPay\SahelPay;

class WebhookController extends Controller
{
    public function handle(Request $request)
    {
        $sahelpay = new SahelPay(config('services.sahelpay.secret_key'));
        
        $isValid = $sahelpay->webhooks->verify(
            $request->getContent(),
            $request->header('X-SahelPay-Signature')
        );

        if (!$isValid) {
            return response()->json(['error' => 'Invalid signature'], 401);
        }

        $event = $request->all();

        if ($event['event'] === 'payment.success') {
            // Mettre à jour la commande
        }

        return response()->json(['received' => true]);
    }
}