Introduction

API Payment

Package Payment

Quick Start

Cette section vise à faciliter la mise en œuvre de nos solutions APIs chez nos clients en fournissant des descriptions de code détaillées et accessibles à tous, quelle que soit leur expérience en programmation. L'objectif est de niveler le terrain et de permettre à tous, débutants comme professionnels, de comprendre et d'utiliser efficacement les APIs. Pour l'instant, copier-coller les codes et remplacer certaines informations par les vôtres.

Le Quick Start ne décrit que les versions beta de nos solutions, uniquement pour vous aider à vous familiariser avec le système. Ces versions sont très importantes pour vos phases de tests. Pour les versions en production, vous lirez la documentation proprement dite en dehors du Quick Start.

N.B: La connexion internet est requise pour toutes ces opérations. Beaucoup oublient d'activer la connexion internet lorsqu'ils travaillent en local alors que toutes ces APIs sont dans un serveur distant. Ne vous inquiétez pas, les APIs ne consomment pas beaucoup.

Formulaire

Dans ce code, nous allons faire le plus simple des codes. Nous allons tester nos APIs mobiles avec du code HTML, rien d'aussi simple. Pour que le formulaire soit accepté par notre système d'APIs, il va falloir qu'il remplisse quelques critères, par critères, nous sous-entendons qu'il s'agit des paramètres et attributs.
Êtes-vous prêts ? Let's go!

HTML 
    <form action="https://payment.labyrinthe-rdc.com/api/beta/mobile" method="post">
        <input type="text" name="token" value="_token" hidden>
        <input type="text" name="reference" value="_reference" hidden>
        <label for="phone"> Phone </label>
        <input type="text" name="phone" id="phone" required>
        <input type="submit" value="Payer">
    </form>
  • action : Dans action, remplissez l'adresse de destination de votre requête. Dans notre cas, c'est le https://payment.labyrinthe-rdc.com/api/beta/mobile.
  • 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. Remplacez donc _token par votre propre token. L'exemple ci-dessous montre uniquement à quoi ressemble un token mais il 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. Cette référence doit être unique à chaque transaction. Elle ne doit pas aussi 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
Maintenant que vous avez compris, veuillez suivre ces étapes pour faire notre première transaction :
  • Copiez et collez le code ci-dessus dans une interface HTML au choix.
  • Faites un design à votre guise.
  • Remplacez les paramètres et attributs (token, url, reference, ...) par vos propres informations.
  • Ouvrez votre page HTML sur un navigateur.
  • Entrez votre numéro pour tenter un paiement.
Exemple :
code-formulaire-exemple

Nous vous avons également préparé une interface uniquement dédiée pour ces tests. Il est libre d'utilisation donc vous pourrez le customiser à votre guise. Tous les inputs ont déjà été préparés, vous allez juste les changer en mettant vos paramètres. Jetez-y un coup d'oeil.

labyrinthe-payment-interface-github
Comment l'avoir ?
  • git clone
    GIT 
        git clone https://github.com/Dr-Lab1/Labyrinthe-Payment-Interface.git

  • github.com: Cliquez sur ce lien ou copiez le pour aller télécharger le fichier ZIP sur github
    LINK 
        https://github.com/Dr-Lab1/Labyrinthe-Payment-Interface.git

N.B: De base, le paiement mobile demande plus de détails que ceux que nous avons cités ici. Tels que le montant, le callbackUrl, la monnaie de transfert,... Mais vu que c'est une version beta, le montant et la monnaie sont définis par le Provider. Ce qui fait que le montant de chaque transfert en beta vaut 100 CDF. La version beta transfert directement l'argent dans le wallet du Provider. Raison pour laquelle le montant de transferts est aussi abordable.