elongo/pay-php

SDK PHP officiel pour Elongo Pay — sessions de checkout et vérification des webhooks.

v0.2.0 2026-07-22 11:57 UTC

Requires

• php: ^8.2
• ext-curl: *
• ext-json: *

Requires (Dev)

• pestphp/pest: ^3.0

MIT

Published on Packagist.org on 2026-07-22 11:58 UTC

README

SDK officiel pour Elongo Pay : crée des sessions de checkout et vérifie les webhooks, sans écrire une seule ligne d'appel HTTP ni de vérification de signature.

Aucune dépendance runtime (cURL + JSON, tous deux fournis par PHP).

Installation

composer require elongo/pay-php

Créer un paiement

Le client est redirigé vers une page hébergée par Elongo Pay. Votre application ne voit jamais de numéro de carte ni de moyen de paiement.

use Elongo\Pay\Client;

$pay = new Client('sk_live_votre_cle');

$session = $pay->checkout->create([
    'amount'              => 25000,
    'currency'            => 'CDF',
    'success_url'         => 'https://votre-app.cd/commande/ok',
    'cancel_url'          => 'https://votre-app.cd/commande/ko',
    'client_reference_id' => $commande->id,
    'metadata'            => ['commande_id' => $commande->id],
], idempotencyKey: "commande-{$commande->id}");

header('Location: '.$session['url']);

L'idempotencyKey (facultative mais recommandée) garantit qu'un rejeu réseau ne crée pas deux sessions pour la même commande.

Récupérer une session ou un paiement

$session = $pay->checkout->retrieve('cs_live_…');
$payment = $pay->payments->retrieve('…');

Vérifier un webhook

Elongo Pay notifie votre callback_url à chaque changement d'état. Vérifiez toujours la signature avant de traiter l'événement : c'est ce qui prouve qu'il vient bien d'Elongo Pay.

use Elongo\Pay\Webhook;
use Elongo\Pay\Exception\ElongoPayException;

$payload = file_get_contents('php://input');
$header  = $_SERVER['HTTP_ELONGO_SIGNATURE'] ?? '';
$secret  = getenv('ELONGO_WEBHOOK_SECRET'); // whsec_…

try {
    $event = Webhook::constructEvent($payload, $header, $secret);
} catch (ElongoPayException) {
    http_response_code(400);
    exit;
}

if ($event['type'] === 'checkout.session.completed') {
    $session = $event['data'];
    // Marquer la commande $session['client_reference_id'] comme payée.
}

http_response_code(200);

Le schéma de signature

Pour les intégrations hors PHP, l'en-tête est documenté et réimplémentable :

Elongo-Signature: t=<timestamp>,v1=<hmac_sha256(secret, "<t>.<payload>")>

Recomposez "<t>.<payload>", calculez le HMAC-SHA256 avec votre secret, comparez en temps constant, et rejetez au-delà de 5 minutes d'écart (anti-rejeu).

Tests

composer install
./vendor/bin/pest

Configuration avancée

// Environnement de test, ou transport personnalisé (tests, proxy).
$pay = new Client('sk_test_…', 'https://api.elongopay.cd', $transport);