Labyrinthe.

• method : Nous gardons la méthode POST
• token : Le token est votre jeton de paiement personnalisé et confidentiel. Il représente vos informations confidentielles et peut être considéré comme votre empreinte numérique. L'exemple ci-dessous montre à quoi ressemble un token mais n'est pas valide.
  Exemple : $2y$12$ngaXsXGwkrxpTAA.ubLXietv/Pdadfbx3OziwIH88inGU4sGi6ivm
  Comment obtenir son token ? Cliquer sur ce lien pour plus d'informations.
• reference : La référence n'est rien d'autre que l'ID de votre transaction. Elle ne doit pas dépasser 50 caractères. Elle vous permet de retracer une à une toutes vos transactions. Et aussi permet d'effectuer bien d'autres actions mais vous les verrez beaucoup plus loin. Pour chaque transaction, prenez soin de toujours changer votre référence.
• phone : C'est le numéro de téléphone par lequel le paiement doit passer. Pour le test, nous vous recommanderons d'abord votre propre numéro de téléphone.
  Nous y sommes presque.
  Entrez un numéro à 9 chiffres (sans le zéro du début) ou à 10 chiffres (avec le zéro du début).
  Exemples :
  • 0891000200
  • 891000200

La réponse est le résultat (ce que retourne) de la requête.

Exemple d'une réponse :

    {
        "success": true,
        "errors": [],
        "array": 
            [
                {
                "success": true,
                "message": "Transaction envoyée avec succès. Veuillez valider le push message",
                "data": {
                    "code": "0",
                    "message": "Transaction envoyée avec succès. Veuillez valider le push message",
                    "orderNumber": "OgLxDSO53TEw243896699032"
                },
                "errors": []
                }
            ]
    }

Il existe plusieurs moyens d'intégrer nos APIs dans vos applications. Le moyen le plus facile est notre package Layrinthe/Payment car avec une seule ligne, vous vous épargnez une dizaine de lignes de codes en plus de l'implémentation de la sécurité. Mais nous vous montrerons les autres méthodes au cas où vous vous sentez moins à l'aise avec le package.

Labyrinthe Package:
La simplicité du package permet une intégration rapide en une seule ligne. Cliquez sur Layrinthe/Payment pour voir comment intégrer le sandbox chez vous.

    $labyrinthe = LabyrintheServiceProvider::sandbox($array);

PHP Native:
Ce code vous permet de faire l'appel des APIs comme avec le package Labyrinthe/Payment mais présente moins d'avantages que le package. Notamment la gestion de la sécurité, le filtre des paramètres (required, type, length), la concision du code, etc.

    $data = array(
        # Remplacez par vos propres informations
        "token" => 'xxxxxxxxxxxxxxxxxxxxxxxxx',
        "phone"=> "0891234567",
        "reference" => "_reference",
    );
    $gateway = "https://payment.labyrinthe-rdc.com/api/beta/mobile";
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $gateway);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 300);
    $response = curl_exec($ch);
    if(curl_errno($ch)) {
        # Erreur !
    }else {
        curl_close($ch);
        $jsonRes = json_decode($response);
        $jsonRes->success;
        if ($jsonRes->success) {
            # La requête retourne la bonne valeur 
        }else{
            # La requête a rencontré des problèmes 
        }
        echo "<pre>";
        print_r($jsonRes);
        echo "<pre>";
    }