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

{
  "repositories": [{ "type": "path", "url": "../sahelpay-sdks/php" }]
}

composer require sahelpay/sahelpay-php:"*"

use SahelPay\SahelPay;

$sahelpay = new SahelPay(
    getenv('SAHELPAY_SECRET_KEY'),         // sk_test_... ou sk_live_...
    null,                                   // clé publique (optionnelle)
    ['webhook_secret' => getenv('SAHELPAY_WEBHOOK_SECRET')]
);

$payment = $sahelpay->payments->initiate([
    'amount' => 5000,
    'provider' => 'ORANGE_MONEY',
    'customer_phone' => '+22370123456',
    'description' => 'Commande #123',
    'client_reference' => 'order-123',
    'return_url' => 'https://votre-site.com/checkout/return?order=order-123',
    'idempotency_key' => 'order-123', // obligatoire côté API : toujours la fournir
]);

header('Location: ' . $payment->redirect_url);
exit;

$link = $sahelpay->paymentLinks->create([
    'name' => 'Commande #123',
    'fixed_amount' => 5000, // prix imposé : le SDK envoie amount_mode FIXED
    'success_redirect_url' => 'https://votre-site.com/merci',
]);

$url = $sahelpay->paymentLinks->getUrl($link->slug); // https://pay.sahelpay.africa/<slug>

$sahelpay->paymentLinks->update($link->id, ['name' => 'Commande #123 (bis)']);
$sahelpay->paymentLinks->delete($link->id); // archivage définitif

$failed = $sahelpay->webhooks->logs(['status' => 'FAILED', 'limit' => 20]);
foreach ($failed->logs as $log) {
    $sahelpay->webhooks->retry($log['id']);
}

$order = $sahelpay->secureOrders->create([
    'amount' => 15000,
    'description' => 'Robe wax taille M',
    'customer_phone' => '+22370000000',
    'idempotency_key' => 'order-9',
]);
$sahelpay->secureOrders->confirmDelivery($order->id, '482913');

$payment = $sahelpay->payments->initiate([
    'amount' => 4000,
    'provider' => 'ORANGE_MONEY',
    'customer_phone' => '+22370123456',
    'hosted_checkout' => false,
    'mock' => true,
    'idempotency_key' => 'test-4000-1',
]);

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

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

$payment = $sahelpay->payments->verify('8d6f1c2e-...');   // GET /v1/payments/{id}/status
echo $payment->status; // INITIATED, PENDING, SUCCESS, FAILED, EXPIRED

$byOrder = $sahelpay->payments->search('order-123');      // par client_reference

use SahelPay\Exceptions\WebhookSignatureException;

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

try {
    $event = $sahelpay->webhooks->constructEvent($rawBody, $signature);
} catch (WebhookSignatureException $e) {
    http_response_code(401);
    exit;
}

if ($event->getType() === 'payment.success') {
    $data = $event->getData(); // client_reference, id, amount...
}

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

public function handle(Request $request, SahelPay $sahelpay)
{
    try {
        $event = $sahelpay->webhooks->constructEvent(
            $request->getContent(),               // corps brut, jamais $request->all()
            $request->header('X-SahelPay-Signature', '')
        );
    } catch (WebhookSignatureException $e) {
        return response()->json(['error' => 'Invalid signature'], 401);
    }

    if ($event->getType() === 'payment.success') {
        // Mettre à jour la commande
    }

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