Documentation PDF

Intégration de l’API PVit Airtel Money
COPYRIGHT
© BakoAI. Tous droits réservés.

Tous les noms ou les marques de produits ou de la société mentionnés dans ce document
sont la propriété de leurs propriétaires respectifs. Aucune partie de ce document ne peut
être reproduite sans la permission de BakoAI.
CONFIDENTIALITE
Le destinataire de ce document s'engage à ne pas divulguer d'information d'ordre

confidentiel. Il n'utilisera pas le contenu sans la permission de BakoAI. De plus, le
destinataire s'engage à ne pas mettre ce document à la disposition de tiers sans notification
écrite de BakoAI.
Si vous n'êtes pas le destinataire de ce document, prière d'en informer BakoAI par email à
l'adresse contact@bakoai.pro, ou par téléphone au (+ 241) 045 742 23 / 025 768 52.
IDENTIFICATION DU DOCUMENT
Date 23/02/2019
Version 2.1
Document Document Technique PVit
Integration du l’API Pvit Airtel Money
Nom Dc_023022019A_ PVit_AirtelMoney _v2.1
INTEGRATION DU PAIEMENT
AIRTEL MONEY VIA PVIT

I. Prérequis
Tout marchand qui souhaiterait utiliser PVit comme moyen de paiement,

devrait :
1. Disposé d’un compte Marchand Airtel Money (Cette inscription est

gratuite chez Airtel Money)
2. Créer son compte chez PVit avec les identifiants de son compte
Marchand Airtel Money.
II. Les différents modules et API.
1. Vous faites un développement natif (web ou mobile) ?

Nous avons deux solutions API pour vous.
- API Formulaire (pour cela, suivez cette documentation
jusqu’au bout)
- API REST (Pour cette API contactez nous)
contact@bakoai.pro
(+241) 045 742 23 / 025 768 52
2. Vous utilisez un CMS (WordPress, Prestashop …)

Nous avons des modules de paiements déjà développés pour vous.
Contactez nous
contact@bakoai.pro
(+241) 045 742 23 / 025 768 52
III. Création du compte PVit
1. Rendez-vous sur la plateforme de

MyPVit (https://mypvit.com)
2. Cliquer sur le bouton « Créer un compte

», vous serez orienté vers la page suivante.
Renseigner tous les champs et cliquer sur le

bouton « S’enregistrer ».
IV. Intégration dans votre application

Afin que PVit puisse effectuer le paiement, vous devez fournir par POST
les valeurs des paramètres suivants :
<form action="https://mypvit.com/airtelmoneypvit.kk" method="POST">

<input type="text" name="tel_marchand" value="04000000"/>
<input type="text" name="montant" value= "00XX"/>
<input type="text" name="ref" value= "FR0054J7PO478"/>
<input type="text" name="redirect" value="https://monsite.com /page_redirect.php"/>
<button><input type="submit" value="Payer avec AirtelMoney" name="payer" ></button>
</form>
1. https://mypvit.com/airtelmoneypvit.kk
Il s’agit du lien vers le service de paiement PVit. Cette information devra

être mise au niveau de l’action de votre formulaire.
2. tel_marchand
C’est le numéro de téléphone Airtel Money du marchand sur lequel PVit va
déverser tous les paiements provenant de votre application.
3. montant
Il s’agit du montant en FCFA que le client doit verser au marchand.
4. Ref
La référence est l’identité unique d’une transaction entre PVit et votre
application
Vous devez générer cette référence unique à chaque demande de paiement.
Cette référence permettra aussi à PVit de renvoyer le statut de la
transaction sur votre URL CallBack.
La référence doit être au maximum de 13 caractères.
5. Redirect
Après chaque paiement, le client est redirigé vers votre application.

« Redirect » est l’argument de cette URL.
NB : Prenez le soin de mettre le chemin complet de votre vos URLs

Exp : https://monsite.com/page_redirect.php
NB : Vous n’aurez pas besoin du numéro de téléphone du client. Ce dernier le renseignera par lui-
même sur la plateforme de PVIT.
Une fois votre formulaire envoyé, le client

sera redirigé vers la page suivante ou il
renseignera son numéro de téléphone
Airtel Money.
Un push lui sera ensuite envoyé sur son

téléphone, ou il saisira son PIN Airtel
Money
V. CallBack URL
Après le traitement, que la transaction aboutisse ou non, PVit vous répond à
travers votre URL CallBack.
Cette réponse est le statut de la transaction, ça référence et le numéro débiteur.
Les données sont envoyées au format XML.
Ainsi, vous devez préparer une page pour la réception de cette réponse. Une fois
la réponse reçue, vous pouvez mettre à jour votre base de données.
<REPONSE>
<INTERFACEID>BAKOAI</INTERFACEID>
<REF>VAL_REF</REF>
<STATUT>CODE_STATUT</STATUT> FR0054J7PO478
<TEL_CLIENT>NUM_CLIENT</TEL_CLIENT> 07000001
</REPONSE>
1. VAL_REF
C’est la référence que vous aviez envoyé lors de la demande de paiement

(l’argument « ref » du formulaire d’envoie)
2. CODE_STATUT
C’est le code correspondant au statut de la transaction. Elle permet de

savoir si la transaction a abouti ou non.
Ce paramètre a toujours la valeur 200 si la transaction a abouti.
Une autre valeur différente de 200 veut dire exactement que le client n’a
pas été débité pour créditer votre compte, par conséquent la transaction a
échoué.
3. TEL_CLIENT
Le numéro the téléphone qui a effectué le paiement.
Les données vous sont envoyées par POST. Donc votre script, vous devez juste
attendre « ref », « statut » et « tel_client » qui signifie respectivement la référence
de la transaction, le statut du paiement et le numéro qui a effectué ce paiement.
Exemple URL Callback en PHP
PVit, après chaque demande de paiement, vous envoie automatiquement une

réponse sur votre URL de CallBack.
Donc que le client clique ou pas sur le bouton « RETOURNER », vous êtes quand
informés du statut de la transaction.
Soit http://monsite.com:9393/weblogic/response_statut.php (mon URL de

callback)
Voici le code php à l’intérieur de cette page

<?php
$data_received=file_get_contents("php://input");
$data_received_xml=new
SimpleXMLElement($data_received);
$ligne_response=$data_received_xml[0];
$reference_received=$ligne_response->REF;
$statut_received=$ligne_response->STATUT;
$num_client=$ligne_response->TEL_CLIENT
?>
Avec les trois variables ($reference_received , $statut_received et $num_client), vous pouvez

aller faire des UPDATE sur les tables de votre BDD
UPDATE ma_table set statut=$statut_received where ref_paiement=$reference_received
L’objectif est de garder une traçabilité dans votre propre base de données.
VI. Interfaces d’Administration
PVit fournit une interface d’administration conviviale qui permet aux marchands de
visualiser toutes les opérations effectuées via PVit. Le tableau de bord inclut des statistiques
et des rapports journaliers, hebdomadaires et mensuels.
Pour y accéder, connectez-vous à l’interface https://mypvit.com

Documentation PDF

Transféré par

Droits d'auteur :

Formats disponibles

Documentation PDF

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Documentation PDF

Transféré par

Droits d'auteur :

Formats disponibles

Intégration de l’API PVit Airtel Money

© BakoAI. Tous droits réservés.

Le destinataire de ce document s'engage à ne pas divulguer d'information d'ordre

AIRTEL MONEY VIA PVIT

Tout marchand qui souhaiterait utiliser PVit comme moyen de paiement,

1. Disposé d’un compte Marchand Airtel Money (Cette inscription est

II. Les différents modules et API.

1. Vous faites un développement natif (web ou mobile) ?

2. Vous utilisez un CMS (WordPress, Prestashop …)

III. Création du compte PVit

1. Rendez-vous sur la plateforme de

2. Cliquer sur le bouton « Créer un compte

Renseigner tous les champs et cliquer sur le

IV. Intégration dans votre application

<form action="https://mypvit.com/airtelmoneypvit.kk" method="POST">

Il s’agit du lien vers le service de paiement PVit. Cette information devra

Après chaque paiement, le client est redirigé vers votre application.

NB : Prenez le soin de mettre le chemin complet de votre vos URLs

Une fois votre formulaire envoyé, le client

Un push lui sera ensuite envoyé sur son

C’est la référence que vous aviez envoyé lors de la demande de paiement

C’est le code correspondant au statut de la transaction. Elle permet de

Le numéro the téléphone qui a effectué le paiement.

Exemple URL Callback en PHP

PVit, après chaque demande de paiement, vous envoie automatiquement une

Soit http://monsite.com:9393/weblogic/response_statut.php (mon URL de

Voici le code php à l’intérieur de cette page

Avec les trois variables ($reference_received , $statut_received et $num_client), vous pouvez

VI. Interfaces d’Administration

Vous aimerez peut-être aussi