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.