Machine Translated by Google

Intégration de la facturation électronique

Guider
APPLICATIONS WEB & MOBILES ET WOOCOMMERCE

Digitech Africa SARL

ANCIENNE SOBRAGA (EN FACE DE L'INSTITUT IRTEC) | CONTACT@DIGITECH­AFRICA.COM
Machine Translated by Google

Guide d'intégration v5
Table des matières

1 INTRODUCTION AU PAIEMENT AVEC E­FACTURATION .................................................. ..................... 3

1.1 L'E­FACTURATION, QU'EST­CE QUE C'EST ? .................................................. .................................................. ........... 3 1.2 L'E­
FACTURATION, COMMENT ÇA MARCHE ? .................................................. .................................................. .... 4

2 TÂCHES D'INTÉGRATION DE HAUT NIVEAU ......................................... ....................................... 5

2.1 TÂCHES D'INTÉGRATION POUR LES APPLICATIONS WEB .................................................. ....................... 5 2.1.1 ÉTAPE 1 :
METTRE EN ŒUVRE L'ACTION DE CONTRÔLE 2.1.2 TÂCHE 2 : METTRE EN ŒUVRE L'APPEL
.................................................. À LA FACTURATION
..................................... 5
ÉLECTRONIQUE...... .................................................. ............................. 6 2.1.3 TÂCHE 3 : METTRE EN ŒUVRE L' ACTION DE
RAPPEL 2.1.4 TÂCHE 4 : CRÉER UNE PAGE DE TRANSACTION RÉUSSIE. ..................................................
.................................................. .................... 6 2.2
.................................. 6
TÂCHES D'INTÉGRATION POUR LES APPLICATIONS MOBILES NATIVES ....................... ..................................... 7 2.2.1 TÂCHE
1 : METTRE EN ŒUVRE L' ACTION DE VÉRIFICATION..... ..........................ERREUR! MARQUET NON DÉFINI.

2.2.2 TÂCHE 2 : METTRE EN ŒUVRE L'APPEL À LA FACTURATION ÉLECTRONIQUE.................ERREUR ! MARQUET NON DÉFINI.
2.2.3 TÂCHE 3 : METTRE EN ŒUVRE UNE REDIRECTION VERS LE PORTAIL DE FACTURATION ÉLECTRONIQUE .......ERREUR ! MARQUET NON DÉFINI.
2.2.4 TÂCHE 4 : METTRE EN ŒUVRE UNE ACTION DE RAPPEL..............ERREUR ! MARQUET NON DÉFINI.
2.2.5 TÂCHE 5 : DÉFINIR LE SCHÉMA D' URI DE L'APPLICATION .................ERROR ! MARQUET NON DÉFINI.
2.2.6 TÂCHE 6 : METTRE EN ŒUVRE UNE API POUR INTERROGER LE STATUT DE PAIEMENT ... ERREUR ! MARQUET NON DÉFINI.

3 ENVIRONNEMENT D'INTÉGRATION ....................................................... .............................................. dix

3.1 PLATEFORME E­BILLING LAB ................................................ .................................................. .......... 10 3.2 SIMULATEUR D'
INTÉGRATION .................................. .................................................. ................... dix

4 ACTIVITÉS D'INTÉGRATION DÉTAILLÉES .................................................. .................................. 11

4.1 PREREQUIS ................................................................ .................................................. ................................. 11 4.1.1 SYSTÈME

BACKEND .................. .................................................. .................................................. 11 4.1 .2 COMPTE MARCHAND E­
FACTURATION .................................................. .................................................. .. 12 4.2 INITIER LE PAIEMENT AVEC LA
FACTURATION ÉLECTRONIQUE .................................. .................................................. 13 4.2.1 ÉTAPE 1 : LE CLIENT CLIQUE
..................................................
SUR LA COMMANDE 14 4.2.2 ÉTAPE 2 : APPELER L'API E­FACTURATION ...............................................
......... .................................................. .......................14
4.2.3 ÉTAPE 3 : METTRE À JOUR LE TABLEAU DES TRANSACTIONS ................. .................................................. ............... 15
4.2.4 ÉTAPE 4 : REDIRECTION DU CLIENT VERS LE PORTAIL DE FACTURATION
ÉLECTRONIQUE ................. .................................................. 15 4.3 RAPPEL DE
L'APPAREIL .. .... .................................................. .................................................. .... 16 4.3.1 CODE DE RÉPONSE HTTP DE
RAPPEL ...................................... .................................................. ...... 16 4.3.2 TESTER LE RAPPEL 16 4.3.3 ENREGISTRER L'
URL DE RAPPEL .......................
..................................................
..................................................
..................................................
....................... 17 .....................

4.3.4 TEST DE RAPPEL DE BOUT EN BOUT 4.4 .................................................. ................................................ 18

CRÉATION D'UNE PAGE DE RÉUSSITE .............................. .................................................. ......................... 21 4.5 ACTIVITÉS
SUPPLÉMENTAIRES POUR L' APPLICATION MOBILE NATIVE .................. ..................................... 22 4.5.1 FOURNIR L'
API ......... .................................................. .................................................. ................ 22

support@digitech­africa.com | Skype : fbikang 1

Machine Translated by Google

Guide d'intégration v5
4.5.2 SCHEMA D'URI OU DEEP LINKING ......................................................... .................................................. ...... 22

5 PREUVES D'UNE INTÉGRATION RÉUSSIE AU LABORATOIRE .................................. .............. 23

6 PLUG­IN WOOCOMMERCE .................................................. .................................................. ..... 26

support@digitech­africa.com | Skype : fbikang 2

Machine Translated by Google

Guide d'intégration v5
1 Introduction au paiement avec E­Billing

1.1 La facturation électronique, qu'est­ce que c'est ?

E­Billing est une passerelle de paiement qui agrège les systèmes de paiement et fournit aux commerçants une API
unique pour intégrer les paiements dans leurs applications.

E­Billing n'est pas un portefeuille mobile.

E­Billing ne gère aucun flux de transaction.

E­Billing ne collecte pas le paiement au nom du marchand. Le paiement est toujours validé par le système de
paiement cible.

E­Billing a mis en place un système automatisé qui assure la traçabilité du paiement des transactions entre le client, le
système de paiement cible et le commerçant.

E­Billing a agrégé avec succès deux (2) systèmes de paiement au Gabon : Airtel Money et MobiCash de Gabon
Telecom.

support@digitech­africa.com | Skype : fbikang 3

Machine Translated by Google

Guide d'intégration v5
1.2 La facturation électronique, comment ça marche ?

E­Billing se connecte aux systèmes backend de Mobile Wallet Platform et à celui du marchand (serveur Web généralement).

Le client se connecte au système backend du marchand à l'aide de son navigateur ou de son application mobile pour effectuer des
achats et passer à la caisse.

Le client se connecte au fournisseur de portefeuille mobile pour payer la transaction à l'aide de son téléphone mobile.

Pour initier une transaction, le client clique sur le bouton Commander (1) à partir du navigateur ou de l'application mobile. Cette action
déclenche l'appel du serveur Web du marchand pour qu'il appelle E­Billing afin de générer un identifiant unique pour la transaction (2).
Le client utilise l'ID de transaction pour initier le paiement avec le portefeuille mobile (3).
Une fois le paiement traité avec succès par le portefeuille mobile, il en informe E­Billing (4). E­Billing notifie à son tour le serveur Web
marchand du paiement réussi de la transaction (5) comme indiqué ci­dessous :

support@digitech­africa.com | Skype : fbikang 4

Machine Translated by Google

Guide d'intégration v5
2 Tâches d'intégration de haut niveau

Dans cette section, nous fournissons une description de haut niveau des tâches que vous devez effectuer pour
l'intégration du paiement avec E­Billing. Vous passerez par des tâches similaires si vous intégrez une autre solution comme
PayPal.

Nous envisageons deux (2) cas d'utilisation : l'intégration du paiement dans une application Web et l'intégration dans
une application mobile native (iOS, Android).

Les tâches principales restent les mêmes pour les deux cas d'utilisation. Pour l'intégration avec une application
mobile native , la principale différence est qu'à un moment donné, le client doit quitter l'application pour accéder à la page de
paiement et après un paiement réussi, il doit quitter le navigateur pour revenir à l'application.

Les tâches principales sont effectuées dans le système backend du commerçant, généralement un serveur Web.

Si vous utilisez WooCommerce pour votre boutique en ligne, un plugin est disponible pour la facturation électronique qui
automatise toutes les étapes d'intégration. Vous trouverez le lien en bas de ce document.

2.1 Tâches d'intégration pour les applications Web

Si votre application est 100% web, responsive, c'est­à­dire accessible depuis plusieurs appareils (ordinateur, tablette,
smartphone), vous devrez effectuer les tâches ci­dessous pour intégrer le paiement à la E­Billing.

2.1.1 Étape 1 : Mettre en œuvre l'action de paiement

L'action de paiement est le point de départ de l'intégration avec E­Billing. Tout ce qui se passe avant est spécifique à
l'application.

À ce stade, l'application doit avoir collecté toutes les informations pour traiter le paiement, y compris, mais sans s'y limiter :

­ Informations client : nom, prénom, email, téléphones, adresse de facturation, adresse de livraison ;
­ Informations sur le produit : nom, description ;
­ Tarification : prix du produit, prix d'expédition, prix total ;

support@digitech­africa.com | Skype : fbikang 5

Machine Translated by Google

Guide d'intégration v5
En cliquant sur le bouton de paiement, le client initie la transaction et il accepte les conditions générales du marchand.

Cette tâche doit créer une entrée dans la base de données dans la table Transaction ou quel que soit son nom.

2.1.2 Tâche 2 : Mettre en œuvre l'appel à la facturation électronique

Cette tâche implémente un appel à l'API E­Billing pour créer un ID unique pour la transaction. Si cette action réussit, cette
tâche doit également rediriger le client vers le portail de paiement E­Billing.

Les informations minimales ci­dessous doivent être fournies à l'API E­Billing pour créer l'ID de transaction :

­ Montant : montant total à régler par le client ;

­ Référence : un identifiant de référence unique pour la transaction dans la base de données du marchand ;
­ Brève description : une brève description de la transaction ;
­ Informations client : nom, téléphone, email, adresse ;
­ URL de la page de réussite : l'URL de la page vers laquelle rediriger le client après une réussite
Paiement;

2.1.3 Tâche 3 : implémenter l'action de rappel

Cette tâche implémente une action de rappel qu'E ­Billing appellera pour informer le marchand du paiement réussi. L'URL doit être
enregistrée sous le profil du marchand dans le portail E­Billing.

Les informations minimales ci­dessous seront fournies lorsque E­Billing appellera l' action de rappel :

­ Référence : l'identifiant de référence unique de la transaction dans la base de données marchand qui a été
fourni lors de la création de l'identifiant de transaction ;
­ Nom du portefeuille mobile : le nom du portefeuille mobile qui a effectué le paiement ;
­ Identifiant de transaction : la transaction unique du système de portefeuille mobile ;

Il s'agit probablement de l'activité de développement la plus importante du processus d'intégration.

2.1.4 Tâche 4 : Créer une page de transaction réussie

Cette tâche crée une page vers laquelle le client sera redirigé par le portail de facturation électronique une fois le paiement réussi
confirmé par le système de portefeuille mobile. L'URL de cette page est envoyée à E­Billing lors de la tâche 2.

support@digitech­africa.com | Skype : fbikang 6

Machine Translated by Google

Guide d'intégration v5
2.2 Tâches d'intégration pour les applications mobiles natives

Si vous avez une application mobile native, iOS et Android, E­Billing propose trois (3) façons d'intégrer le paiement
en ligne.

2.2.1 Utiliser la solution clé en main du portail E­Billing

Vous pouvez compter sur le portail de paiement E­Billing pour permettre au client de sélectionner l'opérateur qu'il
souhaite utiliser pour payer. Avec cette approche, votre application n'a pas besoin de gérer quel opérateur l'utilisateur final
va utiliser pour payer, il le déterminera à partir du portail E­Billing.

Cette approche nécessite simplement que l'utilisateur quitte temporairement l'application et se rende sur le portail et
une fois le paiement effectué, il reviendra.

Schéma d'URI de l'application : le schéma d'URI de l'application. Après un paiement réussi, cet URI sera utilisé pour
revenir à l'application depuis le portail E­Billing, veuillez suivre ces directives :

https://blog.branch.io/how­to­open­an­android­app­from­the­browser/

https://stackoverflow.com/questions/25883113/open­ios­app­from­browser

2.2.2 Facturation électronique Push USSD

La 2ème approche consiste à utiliser l'API Push USSD fournie par E­Billing. Cette approche nécessite que vous laissiez
le client sélectionner l'opérateur qu'il souhaite utiliser pour payer.

Fondamentalement, lorsque l'utilisateur sélectionne l'opérateur et fournit le numéro de téléphone à utiliser pour recevoir
USSD Push, E­Billing enverra USSD Push à l'utilisateur final via l'opérateur choisi.

support@digitech­africa.com | Skype : fbikang 7

Machine Translated by Google

Guide d'intégration v5

2.2.3 Composer le code USSD de facturation électronique

La 3ème approche consiste à composer le code USSD E­Billing directement depuis votre application (Android, iOS),
par exemple : *150*8*5551234567*1# ­ lors de la composition de ce code USSD, l'utilisateur sera invité à saisir son
code PIN pour valider le paiement.

support@digitech­africa.com | Skype : fbikang 8

Machine Translated by Google

Guide d'intégration v5
2.2.4 Tâche 1 : Mettre en œuvre l'action de paiement

L'action de paiement est le point de départ de l'intégration avec E­Billing. Tout ce qui se passe avant est spécifique à
l'application.

À ce stade, l'application doit avoir collecté toutes les informations pour traiter le paiement, y compris, mais sans s'y limiter :

­ Informations client : nom, prénom, email, téléphones, adresse de facturation, adresse de livraison ;
­ Informations sur le produit : nom, description ;
­ Tarification : prix du produit, prix d'expédition, prix total ;

En cliquant sur le bouton de paiement, le client initie la transaction et il accepte les conditions générales du marchand.

Cette tâche doit créer une entrée dans la base de données dans la table Transaction ou quel que soit son nom.

2.2.5 Tâche 4 : implémenter une action de rappel

Cette tâche implémente une action de rappel qu'E ­Billing appellera pour informer le marchand du paiement réussi. L'URL
doit être enregistrée sous le profil du marchand dans le portail E­Billing.

Les informations minimales ci­dessous seront fournies lorsque E­Billing appellera l' action de rappel :

­ Référence : l'identifiant de référence unique de la transaction dans la base de données marchand qui a été
fourni lors de la création de l'identifiant de transaction ;
­ Nom du portefeuille mobile : le nom du portefeuille mobile qui a effectué le paiement ;
­ Identifiant de transaction : la transaction unique du système de portefeuille mobile ;

Il s'agit probablement de l'activité de développement la plus importante du processus d'intégration.

2.2.6 Tâche 6 : Implémenter une API pour interroger l'état du paiement

Lorsque le client revient à l'application mobile, le backend du marchand a déjà été mis à jour. L'application mobile doit
pouvoir interroger le backend pour obtenir une mise à jour de l'état du paiement.

IMPORTANT:

Lorsque le paiement est validé par l'opérateur, E­Billing en sera automatiquement averti. Dès réception de cette
notification, E­Billing informera votre application principale du paiement réussi.

L'application dorsale doit fournir une API à l'application mobile pour interroger l'état du paiement. L'application mobile ne
doit pas demander l'état du paiement directement à l'application E­Billing.

support@digitech­africa.com | Skype : fbikang 9

Machine Translated by Google

Guide d'intégration v5
3 Environnement d'intégration

L'environnement d'intégration comprend deux (2) outils essentiels : la plateforme E­Billing Lab et le simulateur
d'intégration.

3.1 Plateforme de laboratoire de facturation électronique

La plate­forme de laboratoire est fonctionnellement identique à la production. Cela permet de s'assurer que lorsque vous
pourrez terminer l'intégration et les tests dans Lab, tout devrait fonctionner correctement en production.

Voici l'URL du Lab : https://lab.billing­easy.net

3.2 Simulateur d'intégration

Un simulateur est disponible pour vous fournir un outil pour tester la plupart des tâches d'intégration.

Voici l'URL du Simulateur d'Intégration : https://simu.billing­easy.net

Avec le simulateur, vous pourrez tester séparément les fonctionnalités suivantes :

(1) Redirection vers la page de réussite du paiement : il s'agit d'un test très basique, il vous suffit de spécifier l'URL
et de vous assurer que vous êtes redirigé vers la page ;
(2) Action de rappel : ce test est extrêmement important. Vous fournissez l'URL de votre rappel et
vous sélectionnez les paramètres que vous souhaitez recevoir ;
(3) Test de bout en bout : il s'agit d'un test obligatoire qui doit être réussi afin de valider votre intégration avec E­Billing ;

support@digitech­africa.com | Skype : fbikang dix

Machine Translated by Google

Guide d'intégration v5
4 Activités d'intégration détaillées

Dans cette section, nous approfondissons les tâches d'intégration que vous devez effectuer pour ajouter le paiement
avec E­Billing à votre application, qu'elle soit web ou mobile native.

4.1 Prérequis
Citons d'abord ce que vous devez avoir en main pour l'intégration du paiement avec E­Billing.

4.1.1 Système dorsal

Que vous intégriez ou non le paiement sur votre application Web ou votre application mobile native , vous devez disposer
d'un système backend, généralement un serveur d'applications Web.

Dans votre système backend, vous devez disposer d'une base de données avec une table pour suivre l'état du paiement.
Nommons cette table : TRANSACTION avec au moins les colonnes suivantes :

Bien sûr, vous pouvez ajuster le type/nom de colonne pour mieux répondre à vos besoins/environnement.

Le paiement avec E­Billing se fait de manière asynchrone :

(1) Vous soumettez le paiement ;

(2) Vous attendez d'être notifié par un système externe (E­Billing) lorsque le paiement est validé par l'opérateur ou
la banque ;

Cette table TRANSACTION est un moyen pour vous de : (1)

Garder une trace de toutes les transactions initiées ; (2)

Identifiez quelle transaction a été payée lorsque vous recevez une notification d'E­Billing ; (3) Identifier les
transactions non payées ou expirées ; (4) Fournir des informations de paiement au client ; (5) Etc.

support@digitech­africa.com | Skype : fbikang 11

Machine Translated by Google

Guide d'intégration v5
Le statut de la colonne peut être utilisé pour suivre l'état de la transaction, vous pouvez définir ces valeurs par
exemple :

­ Créé : statut juste après la création de la nouvelle entrée et avant d'obtenir l'identifiant unique du
transaction depuis E­Billing ;
­ En attente : il peut s'agir du statut après avoir reçu l'identifiant unique d'E­Billing ;
­ Payé : il peut s'agir du statut après réception de la notification de paiement par E­Billing ;
­ Expiré : il peut s'agir du statut si la transaction n'a pas été payée après le délai ;

4.1.2 Compte marchand E­Facturation

Pour commencer l'intégration, vous devez disposer des informations de votre compte marchand E­Billing dans
l'environnement LAB.

Voici l'URL de LAB : https://lab.billing­easy.net

Voici l'URL pour créer votre compte marchand si vous n'en avez pas déjà : https://lab.billing easy.net/merchant/
registrations/new

Vous avez besoin des informations suivantes de votre compte E­Billing :

(1) Nom d'utilisateur

(2) Mot de passe
(3) Clé partagée

support@digitech­africa.com | Skype : fbikang 12

Machine Translated by Google

Guide d'intégration v5
4.2 Initier le paiement avec E­Billing
La première tâche de l'intégration consiste à lancer le paiement avec le bouton de paiement . Voici un exemple de
www.smspushpro.com :

À ce stade, toutes les informations nécessaires au traitement du paiement ont déjà été collectées.

Lorsque le client clique sur "Payer" l'équivalent de "Checkout", il sera dirigé vers cette page ci­dessous :

Il s'agit de la page de paiement standard de la plateforme E­Billing. Il fournit au client des procédures pour payer avec son
portefeuille mobile préféré ou son application bancaire. Les étapes de paiement sont totalement transparentes pour le
commerçant.

support@digitech­africa.com | Skype : fbikang 13

Machine Translated by Google

Guide d'intégration v5
L'initiation de la transaction avec E­Billing se fait en cinq (5) étapes comme détecté ci­dessous :

4.2.1 Étape 1 : le client clique sur le paiement

Après avoir collecté les informations de transaction, vous devez essentiellement créer une entrée dans le tableau
TRANSACTION qui devrait ressembler à ceci :

4.2.2 Étape 2 : appeler l'API E­Billing

Dans cette étape, vous devez appeler l'API REST E­Billing pour créer une transaction.

Chemin API : /api/v1/merchant/e_bills

­ LAB : https://lab.billing­easy.net/api/v1/merchant/e_bills ­ PROD : https://

www.billing­easy.com/api/v1/merchant/e_bills

Verbe API : POST

support@digitech­africa.com | Skype : fbikang 14

Machine Translated by Google

Guide d'intégration v5
Voici la liste des paramètres de l'API :

Vous trouverez des exemples de code en PHP et Java pour y parvenir à la fin du document.

4.2.3 Étape 3 : Mettre à jour la table TRANSACTION

Ce tableau devrait ressembler à ceci après cette étape :

­ la colonne d' état est passée de créé à en attente ; ­ La colonne

ebilling_id a été mise à jour avec la valeur renvoyée par E­Billing ;

4.2.4 Étape 4 : rediriger le client vers le portail E­Billing

Si le client achète à partir d'un navigateur ou d'une application mobile native, vous devez le rediriger vers le portail de
facturation électronique. Vous devez passer 2 paramètres dans la méthode POST :

­ numéro_facture : il s'agit de l'identifiant unique de transaction généré par E­Billing ; ­

marchand_redirect_url : il s'agit de l'URL vers laquelle E­Billing redirigera le client en cas de paiement ;

Voici un exemple de code PHP :

// Port de paiement LAB

$POST_URL = 'https://test.billing­easy.net';

// Page de réussite du marchand

$invoice_number = 'URL à déterminer' ;

// Récupère la réponse au format JSON

$response = json_decode($json_response, true);

// Récupère la transaction à partir de la réponse E­Billing

$invoice_number = $response['e_bill']['bill_id'] ;

// Rediriger vers le portail E­Billing

echo "<form action='" . $POST_URL . "' method='post' name='frm'>" ;

echo "<input type='hidden' name='invoice_number' value='".$invoice_number."'>" ;

echo "<input type='hidden' name='merchant_redirect_url' value='".$merchant_redirect_url."'>" ;

echo "</form>" ;

echo "<script language='JavaScript'>" ;

echo "document.frm.submit();";

echo "</script>" ;

support@digitech­africa.com | Skype : fbikang 15

Machine Translated by Google

Guide d'intégration v5
4.3 Mettre en œuvre le rappel

Cette activité se déroule de votre côté. Vous devez créer une action de rappel et enregistrer son URL dans le profil
marchand du portail E­Billing.

Ce qui est effectué pendant le rappel est totalement transparent pour le client. L'action de rappel est utilisée par E
Billing pour informer votre backend que le paiement a réussi. Le rappel n'a aucune interaction avec le client. Il n'y a
pas de page visuelle.

Au minimum, le rappel doit mettre à jour la table TRANSACTION comme suit :

­ La colonne de statut a été mise à jour d' en attente à payée ;

­ Paid_at a été mis à jour avec la date et l'heure de réception du rappel ;
­ La colonne Opérateur a été mise à jour avec le nom de l'opérateur ;
­ La colonne Transaction_id a été mise à jour avec la valeur de l'opérateur ;

4.3.1 Code de réponse HTTP de rappel

Lors de l'appel de l'action de rappel, E­Billing vérifiera le code HTTP renvoyé pour déterminer si la notification de
paiement a été traitée avec succès par le marchand.

Il est important de vous assurer de renvoyer 2xx si le traitement a réussi et 4xx s'il y a eu un
Erreur.

4.3.2 Tester le rappel

Vous pouvez utiliser le simulateur d'intégration pour tester votre action de rappel. Voici l'URL : https://
simu.billing­easy.net/callback­url

support@digitech­africa.com | Skype : fbikang 16

Machine Translated by Google

Guide d'intégration v5
Le simulateur appellera l'action de rappel avec les paramètres sélectionnés. Les noms de paramètres sont exactement tels qu'ils
sont affichés.

4.3.3 Enregistrer l'URL de rappel

Si le test de rappel réussit, vous pouvez enregistrer l'URL dans le portail de facturation électronique sous le profil du marchand.

Après vous être connecté au marchand, accédez à "Profil" dans le coin supérieur droit :

Sur la page qui suit, veuillez cliquer sur le bouton « Modifier » puis allez dans la section « URL de notification » :

Ce que vous devez faire, c'est :

­ Entrez votre URL de rappel ;

­ Sélectionnez les paramètres que vous souhaitez recevoir, au minimum : transactionid, reference,
système de paiement, montant ;

support@digitech­africa.com | Skype : fbikang 17

Machine Translated by Google

Guide d'intégration v5
4.3.4 Test de rappel de bout en bout

Une fois le rappel enregistré dans le profil du marchand, vous pouvez procéder à des tests de bout en bout. Pour
cela vous utiliserez le bouton « Tester le paiement end­2­end » :

Sur la page qui suit, veuillez entrer le numéro de facture (ID de la transaction) comme indiqué ci­dessous et cliquez
sur "Demander la facture"

Sur l'écran qui suit, veuillez sélectionner l'opérateur que vous souhaitez et cliquez sur "Payer la facture"

support@digitech­africa.com | Skype : fbikang 18

Machine Translated by Google

Guide d'intégration v5

Lorsque vous cliquez sur "Payer la facture", vous simulez essentiellement la validation du paiement par le
fournisseur de portefeuille. Le simulateur est connecté à la plateforme LAB. Lorsque LAB reçoit la confirmation
de paiement, il avertit immédiatement le commerçant en appelant le rappel enregistré dans son profil.

L'écran ci­dessus indique que la plate­forme LAB a reçu avec succès la notification de paiement du
système de paiement (simulateur).

support@digitech­africa.com | Skype : fbikang 19

Machine Translated by Google

Guide d'intégration v5

Lorsque la plate­forme de paiement (simulateur) notifie E­Billing (1), E­Billing met à jour le statut de la transaction
dans le système (2) et confirme renvoie la confirmation au système de paiement (3), puis E­Billing envoie une
notification au commerçant en utilisant le rappel enregistré ( 4) et E­Billing s'attend à ce que le rappel du
commerçant renvoie HTTP 200 (ou 2xx) pour marquer la transaction comme traitée (5).

À ce stade, vous devez vérifier sur votre système backend que le rappel a été exécuté avec succès.
Normalement, vous avez testé avec succès votre callback individuellement avec un simulateur, il ne devrait
pas y avoir de surprise avec le test end­2­end.

Il est très important de s'assurer que le code HTTP renvoyé par callback correspond au code réel exécuté
Etat:

• HTTP 200 si l'exécution a réussi ; • HTTP 4xx si

l'exécution a échoué ;

Cela garantira que E­Billing signale correctement l'état de la transaction.

Vous trouverez ci­dessous le cycle de vie de la transaction dans le système de facturation électronique :

En cas d'échec de l'exécution du rappel , la transaction restera à l'état Payé

support@digitech­africa.com | Skype : fbikang 20

Machine Translated by Google

Guide d'intégration v5
4.4 Créer une page de réussite

Semblable au rappel, la page de réussite est l'URL physique du client vers laquelle le client sera redirigé une
fois le paiement validé par le système de paiement tiers .

Voici le portail E­Billing lorsque le paiement est validé :

Vous pouvez remarquer « RETOUR AU SITE » qui fournit un lien pour revenir au site marchand et plus précisément à la
page de paiement réussie.

Voici un exemple de page de réussite pour le site Web SMSPUSH :

support@digitech­africa.com | Skype : fbikang 21

Machine Translated by Google

Guide d'intégration v5
4.5 Activités supplémentaires pour l'application mobile native

Si vous intégrez le paiement dans une application mobile native (iOS, Android), toutes les activités précédentes sont
applicables, mais en plus de cela, il y a des tâches supplémentaires liées à l'intégration de la facturation électronique,
nous sommes à peu près sûrs qu'elles sont les mêmes pour toute autre passerelle de paiement. comme PayPal.

Comme mentionné dans l'introduction, les applications mobiles n'interagissent pas directement avec la facturation électronique.
Au lieu de cela, ils interagissent avec leur serveur principal, généralement un serveur Web.

4.5.1 Fournir une API

Il y a bien sûr 100 façons d'y parvenir. Notre recommandation serait de fournir au moins 2 API :

(1) Paiement : cette API serait utilisée par vos applications mobiles pour initier une transaction de paiement ;
(2) Requête : cette API serait utilisée pour interroger l'état du paiement ;

4.5.2 Schéma d'URI ou lien profond

Comme pour PayPal, le client doit quitter les applications mobiles natives et être dirigé vers la page de paiement de la
facturation électronique. Après le paiement, nous avons besoin d'un moyen de ramener l'utilisateur à l'application.

Vous pouvez y parvenir en créant un schéma d'URI, par exemple myappli­success:// et en utilisant des liens profonds.

Vous fournirez essentiellement le schéma URI au portail E­Billing en tant qu'URL de redirection lorsque vous appelez E­Billing
pour initier la transaction. https://blog.branch.io/how­to­open­an­android­app­from­the­browser/

https://stackoverflow.com/questions/25883113/open­ios­app­from­browser

support@digitech­africa.com | Skype : fbikang 22

Machine Translated by Google

Guide d'intégration v5
5 Preuve d'une intégration réussie dans LAB

Avant de pouvoir passer à l'environnement de production E­Billing, vous devez prouver que votre intégration a réussi dans
l'environnement LAB.

Pour rappel, LAB est fonctionnellement identique à la production. Si votre intégration se fait avec succès dans LAB,
vous avez la garantie qu'elle fonctionnera en production. Le passage en production consiste simplement à modifier les URL et
les informations d'identification.

Par conséquent, veuillez prendre votre temps pour exécuter tous les tests dans LAB et ne pas rogner, vous pouvez faire autant
de tests que nécessaire pour vous assurer que tout fonctionne bien.

Vous trouverez ci­dessous les preuves minimales à fournir que l'intégration a réussi dans LAB avec
Application SMSPUSH :

(1) Copie de l'écran de la page de paiement : le client initie la transaction

(2) Copie de l'écran du portail E­Billing : pour montrer que le client est redirigé vers la page de paiement

À partir de là, utilisez le simulateur pour payer la transaction.

support@digitech­africa.com | Skype : fbikang 23

Machine Translated by Google

Guide d'intégration v5
(3) Copie de l'écran indiquant que le paiement a été reçu par E­Billing

Après l'expiration du compteur, le client doit être redirigé vers la page de réussite du marchand.

(4) Copie de la page marchand réussie

Ici le client peut voir sur le site marchand que son paiement a été validé.

support@digitech­africa.com | Skype : fbikang 24

Machine Translated by Google

Guide d'intégration v5
(5) Copie de l'écran de l'état de la transaction dans E­Billing LAB pour montrer que son état est Traité

support@digitech­africa.com | Skype : fbikang 25

Machine Translated by Google

Guide d'intégration v5
6 Plugin WooCommerce

Pour ceux qui utilisent WooCommerce pour leur boutique en ligne, le plugin officiel E­Billing est maintenant
disponible. Le plugin automatise toutes les étapes d'intégration du bouton de paiement à la redirection du
client vers la page de réussite du paiement.

Voici le lien vers le plugin E­Billing Gateway Payment pour WooCommerce :

https://wordpress.org/plugins/e­billing­payment­gateway/

Vous trouverez tous les détails pour installer et configurer le plugin.

support@digitech­africa.com | Skype : fbikang 26