kongofiscal / kongoconnect-php
Official PHP SDK for KongoConnect Platform
v1.0.1
2026-06-29 11:56 UTC
Requires
- php: >=8.0
- ext-curl: *
- ext-json: *
- ext-openssl: *
README
Le SDK officiel PHP pour interagir avec l'API KongoFiscal. Il n'a aucune dépendance tierce et utilise nativement l'extension cURL et OpenSSL pour des performances optimales.
Installation
Vous pouvez installer cette librairie via Composer :
composer require kongofiscal/kongoconnect-php
Configuration (Variables d'Environnement)
Le SDK récupère automatiquement la configuration depuis vos variables d'environnement (.env ou système). Ajoutez-y ces trois clés :
KONGO_LICENSE_KEY=votre_cle_de_licence_ici KONGO_DEVICE_TOKEN=votre_token_appareil_ici KONGO_BASE_URL=https://localhost:5001
Utilisation
Option 1 : Utilisation Facile avec Facade (Recommandé)
<?php require 'vendor/autoload.php'; use KongoConnect\Sdk\Facades\KongoConnect; use KongoConnect\Sdk\Models\FiscalTransactionRequest; // Initialisation (pas besoin de paramètres si vos variables d'environnement sont définies) KongoConnect::init(); $request = new FiscalTransactionRequest( transactionId: "TX-" . time(), payload: ["amount" => 1500, "currency" => "CDF"] ); $response = KongoConnect::sendTransaction($request); print_r($response);
Option 2 : Intégration dans Laravel / Symfony
Laravel : Le SDK inclut un LaravelServiceProvider.
Si vous souhaitez publier le fichier de configuration :
php artisan vendor:publish --tag=kongoconnect-config
Puis, utilisez simplement la Facade \KongoConnect\Sdk\Facades\KongoConnect::sendTransaction(...) n'importe où dans vos contrôleurs.
Fonctionnalités
- Compatible PSR-4.
- Prise en charge native de l'algorithme AES-256-GCM.
- Gestion intelligente des variables d'environnement.