Version Date Par Description

1.0 2018-08- Thierry Consultant technique

24 Narcisse M.
1.1 2018-09- Saka Responsable technique
12 Rukayatou
1.2 2021-02- Saka Responsable technique
27 Rukayatou

Procédure technique de connexion à la plateforme de paiement en ligne de Paiement

Pro

Tél: (225) 21 21 48 50 Cel: (225) 78 25 22 83 www.paiementpro.net info@paiementpro.net

 TABLES DES MATIERES
1. Objectifs .................................................................................................................... 3
2. Principes de fonctionnement ..................................................................................... 3
a. Initialisation de la session onlinepayment ................................................................. 3
b. Redirection du partenaire vers plateforme paiementpro ............................................ 5
c. Notification et Redirection paiementpro vers partenaires .......................................... 5
3. Statuts des paiements .............................................................................................. 6

Tél: (225) 21 21 48 50 Cel: (225) 78 25 22 83 www.paiementpro.net info@paiementpro.net

 1. Objectifs
Ce document décrit la procédure à utiliser par un partenaire pour l'interconnexion avec
la plateforme Paiement Pro en vue de mettre à la disposition des clients, un moyen de
paiement en ligne simple, fiable et sécurisé.

2. Principes de fonctionnement
La procédure de paiement se fait en plusieurs étapes détaillées ci-dessous, à savoir :
l'initialisation, la redirection vers le portail de Paiement Pro, la notification du partenaire
et la redirection sur le site du partenaire.

a. Initialisation de la session onlinepayment

Sur le site du partenaire, lorsque le client choisi de lancer le paiement, le partenaire doit
effectuer une initialisation de cette session sur le site de Paiement Pro, qui consiste en
un service web entre les deux serveurs (Paiement Pro et partenaire), par l’appel de la
fonction initTransact qui prend des paramètres en entrée et qui retourne une sessionid
qui sera utilisé pendant toute la session. Les paramètres de cette requête sont décrits
dans le tableau ci-dessous :

Paramètre Description Obligatoire

merchantId Identifiant unique du partenaire OUI
countryCurrencyCode code devise (la valeur par defaut est celui du CFA) NON
referenceNumber Reference du paiement ou de la transaction chez le partenaire OUI
amount montant de la transaction OUI
Code du canal de paiement (OMCIV2,MOMO,CARD,FLOOZ ,PAYPAL).
Si ce paramètre n’a pas été défini à l’initialisation, une redirection automatique
channel vers une page de choix du channel va etre faite NON
customerId Identifiant du client NON
customerEmail Email du client OUI
customerFirstName Prénom du client OUI
customerLastName Nom du client OUI
customerPhoneNumber Téléphone du client OUI
description Description de la transaction NON
Url de notification automatique du résultat de la transaction(succes, echec,
notificationURL annulé) au partenaire OUI
returnURL Url de retour sur la plateforme du partenaire OUI
Chaines de caractères (variables) transmis à Paiement Pro et retransmis telle
returnContext que au partenaire NON
hashcode Chaine crypté pour garantir la sécurité des données transmises OUI

Tél: (225) 21 21 48 50 Cel: (225) 78 25 22 83 www.paiementpro.net info@paiementpro.net

Retour : Une réponse est renvoyée sous forme d’objet Response avec les éléments ci-
dessous
Paramètre Description
Code Code de réponse
Description Description réponse
Identifiant unique de la session sur Paiement Pro ou null si l’initialisation n’a pas
Sessionid
été effectuée

Code Description
0 Succès
10 Paramètres insuffisants
11 ID marchand inconnu
-1 Erreur initialisation

Url :https://www.paiementpro.net/webservice/OnlineServicePayment_v2.php?wsdl
Exemple:
<?php
ini_set("soap.wsdl_cache_enabled", 0);
$url="https://www.paiementpro.net/webservice/OnlineServicePayment_v2.php?wsdl";
$client = new SoapClient($url,array('cache_wsdl' => WSDL_CACHE_NONE));
$array=array( 'merchantId'=>'PP-F105',
'countryCurrencyCode'=>'952',
'amount'=>1000,
'customerId'=>1,
'channel'=>'CARD',
'customerEmail'=>'t@t.ci',
'customerFirstName'=>'Thierry',
'customerLastname'=>'Narcisse',
'customerPhoneNumber'=>'22507517917',
'referenceNumber'=>'878AABCDEFZ'.time(),
'notificationURL'=>'http://test.ci/notification/',
'returnURL'=>'http://test.ci/return/',
'description'=>'achat en ligne',
'returnContext'=>'test=2&ok=1&oui=2',
);
try{
$response=$client->initTransact($array);

Tél: (225) 21 21 48 50 Cel: (225) 78 25 22 83 www.paiementpro.net info@paiementpro.net

if($response->Code==0){

//var_dump($response->Sessionid);die();

header("Location:https://www.paiementpro.net/webservice/onlinepayment/processing_v
2.php?sessionid=".$response->Sessionid);

}
}
catch(Exception $e)
{
echo $e->getMessage();
}
?>
b. Redirection du partenaire vers plateforme paiementpro
Après l'obtention de la sessionid, le partenaire doit effectuer une redirection
(HTTP_POST) vers l'URL de Paiement Pro en postant des paramètres. Cette redirection
ouvre la session préalablement crée lors de l'initialisation. Les paramètres de cette
requête sont décrits dans le tableau ci-dessous :

Paramètre Description Obligatoir

sessionId Identifiant unique de la session (valable 5 mn) OUI

URL: https://paiementpro.net/webservice/onlinepayment/processing_v2.php
Si lors de l’étape de l’initialisation du paramètre channel n’a pas été définie ou que
channel=”” alors après l’appel de la page processing_v2.php une redirection
automatique est fait vers l’URL ci-dessous pour permettre de choisir le moyen de
paiement (channel) :
https://www.paiementpro.net/webservice/onlinepayment/v2/paychannel.php

c. Notification et Redirection Paiement Pro vers partenaires

Une Notification est effectuée en cas de succès, erreur ou annulation vers l’url de
notification spécifié par le partenaire avec les paramètres ci-dessous :
Paramètre Description
merchantId Identifiant unique du partenaire
countryCurrencyCode code devise

Tél: (225) 21 21 48 50 Cel: (225) 78 25 22 83 www.paiementpro.net info@paiementpro.net

referenceNumber Reference du paiement ou de la transaction chez le partenaire
amount montant de la transaction
transactiondt Date et heure de la transaction
customerId Identifiant du client
Chaines de caractères (variables) transmis à paiementpro et
returnContext retransmis telle quelleau partenaire
responsecode Code réponse du serveur de paiemement pro
hashcode Chaine crypté pour garantir la sécurité des données transmises

3. Statuts des paiements

Code Description
0 Transaction réussi
-1 Transaction échoué

Tél: (225) 21 21 48 50 Cel: (225) 78 25 22 83 www.paiementpro.net info@paiementpro.net