Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https:

02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 1/10 Tutoriel pour apprendre l'intégration de l'API de paiement Mobile Money AByster sur un site marchand Cas PHP Table des matières I. Introduction II. Définitions III. Prérequis IV. Cas d'étude V. Transactions en mode démo V-A. Service de paiement d'une commande V-B. Service de vérification du statut du paiement d'une commande VI. Transaction en mode réel VII. Simulateur Mobile Money VIII. Utilisation d'un terminal mobile IX. Liens et ressources Le but de ce tutoriel est de vous apprendre à intégrer l'API de paiement mobile Abyster sur un site web marchand, développé en PHP. 2 commentaires Article lu 9428 fois. L'auteur jm ntepp L'article Publié le 25 juin 2016 - Mis à jour le 25 juin 2016 Durée : 45 minutes Version PDF Version hors-ligne ePub, Azw et Mobi Liens sociaux I. Introduction▲ La prolifération des sites web de e-commerce, amène plusieurs banques et entreprises à se lancer dans le développement des solutions de paiement en ligne. Aujourd'hui, il en existe plusieurs, notamment : Paypal, Visa et bien d'autres. AByster est l'une de ces solutions de paiement en ligne, mais ayant la particularité d'utiliser le Mobile Money. Pour le moment, le système est disponible uniquement dans les pays d'Afrique représentés sur la figure 1 ci-dessous disposant des services Mobile Money, car dans d'autres pays notamment en Afrique de l'Est, d'autres opérateurs y sont présents et disposent d'un autre système de paiement par mobile : le par exemple. La solution de paiement fonctionne actuellement au Cameroun et au Sénégal. FORUMS TUTORIELS FAQ BLOGS CHAT NEWSLETTER EMPLOI ÉTUDES DROIT CLUB Dév. Web AJAX Apache ASP CSS Dart Flash / Flex JavaScript NodeJS PHP Ruby TypeScript Web sémantique Webmarketing (X)HTML Forum PHP FAQ PHP Cours PHP Sources PHP Livres PHP Scripts PHP Outils PHP Laravel Symfony Zend Framework Partager DI/DSI Solutions d'entreprise Cloud IA ALM Microsoft Java Dév. Web EDI Programmation SGBD Office Mobiles Systèmes 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 2/10 Figure 1 : Zone de chalandise de AByster La solution ABYster fonctionne actuellement pour les opérateurs téléphoniques MTN et Orange. Le présent tutoriel a pour objet de présenter comment intégrer la version 2.0 de l'API AByster sur un site web de e-commerce développé en PHP. Il donne aux web masters et développeurs des informations utiles leur permettant d'utiliser facilement l'API AByster sur des sites et applications web. Le présent document fait partie intégrante des ressources soumises aux CGU (Conditions Générales d'Utilisation) du service Abyster. II. Définitions▲ Termes Signification AByster désigne la société AByster API Application Programming Interface CGU Conditions Générales d'Utilisation du service AByster MM Compte Mobile Money URI Uniform Resource Identifier URL Uniform Resource Location JSON JavaScript Object Notation ${ABYSTERURL} Fait référence à l'environnement AByster avec lequel le site marchand communique III. Prérequis▲ 1. Un éditeur de code source PHP de votre choix. Nodepad++, SublimeTex… 2. Un compte Entreprise sur la plateforme AbysterURL. Un serveur Apache : l'outil EasyPHP est suffisant pour ce tutoriel. Pour être autorisé à utiliser les API AByster, il faut posséder un compte AByster Entreprise (dit compte Marchand). Pour ce faire, clic sur le bouton Ouvrir un compte sur le site AByster et suivez les étapes. À la fin du processus de création de compte, vous recevez par mail vos paramètres d'authentification pour l'utilisation des API. · Clé privée (clé privée du compte AByster du marchand : consummerSecret). · Identifiant (Identifiant du compte Abyster du marchand : consummerId). IV. Cas d'étude▲ Dans ce tutoriel, nous considérons un minisite marchand fournissant une vitrine permettant d'acheter via Mobile Money l'un de ses quatre produits phares. Demoshop V. Transactions en mode démo▲ Étape1 : Création de compte Marchand sur la plateforme de test 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 3/10 Allez sur http://sandbox-abyster.appspot.com, cliquez sur le bouton Ouvrir un compte Ici, le système vérifie si le numéro de téléphone ou l'e-mail ne sont pas encore alloués à un marchand. Complétez la création de votre compte si la vérification est positive. Création du compte Vous recevez par e-mail vos paramètres d'authentification pour l'utilisation de l'API. 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 4/10 Paramètres d'authentification Étape2 : Configuration des paramètres d'appel Une fois votre compte AByster créé, vous pouvez utiliser l'API moyennant le respect des structures des requêtes qui lui sont destinées. Chaque appel à l'API doit se faire via une requête HTTP possédant les paramètres d'entête avec des valeurs spécifiques : Accept : « application/json» Accept-Encoding : « deflate » Content-Type : « application/json » code php Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 5/10 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. 71. 72. 73. 74. 75. 76. 77. 78. 79. 80. 81. 82. 83. 84. 85. 86. 87. 88. 89. 90. 91. 92. 93. 94. 95. 96. 97. 98. 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 6/10 <?php $ApiUrl='http://sandbox-abyster.appspot.com/rest/api/v2'; $consumerId='5671831268753408'; $consumerName='employeur'; $consumerEmail='demoshop@demoshop.com'; $consumerSecret='CA1764U8MRL4E65H5EIA19K0FIAFL-e21a6b31-6f9e-4163-b6d6- 41a230ceaac9';//'8EE5GRNUTM2CVVE8C7KRIUS4UEMVP-b0b3c3a7-7b62-4a2f-afd0-4ce3320226d4'; $consumerTimestamp=substr(date('Ymdhisu'),0,17); //echo $consumerTimestamp." "; //Calcule du consumerToken $consumerToken=$consumerId.$consumerTimestamp.$consumerSecret; $consumerToken=md5($consumerToken); //echo $consumerToken.' '; //Configuration de l'entête $header=array(); $header[]="Accept:application/json"; $header[]="Accept-Encoding:deflate"; $header[]="Content-Type:application/json"; $header[]="Authorization:AUTH consumerEmail=\"".$consumerEmail. "\",consumerTimestamp=\"".$consumerTimestamp."\",consumerToken=\"".$consumerToken."\",consum $racine=array(); $order=array(); $amount=array(); $buyer=array(); $receiver=array(); $receiver1=array(); $receivers=array(); //information sur la commande $order["reference"]="V0Y01"; $order["redirectUrl"]='http://localhost/demoshop.com/traitement.php'; $amount["amountTTC"]=$_POST["prix"]; $amount["currency"]="XAF"; $amount["paymentMethod"]="TRANSFERT_MOBILE_MONEY"; //information sur le client $buyer["msisdn"]="00237".$_POST["phone_mobile"]; $buyer["email"]="tatampion@yahoo.fr"; $buyer["name"]=$firstname = $_POST["firstname"]; $buyer["operateur"]="OrangeMoney"; //debut information sur le destinataire du paiement $buyer1["msisdn"]="00237666666666"; $buyer1["email"]="tatampion@yahoo.fr"; $amount1["amountTTC"]=$_POST["prix"]; $amount1["currency"]="XAF"; $amount1["paymentMethod"]="TRANSFERT_MOBILE_MONEY"; //cas 1 receiver $receiver1["buyer"] = $buyer1; $receiver1["amount"] = $amount1; $receiver1["description"] = "paiement de la commande à un bénénéficiaire"; $receivers[] = $receiver1; $racine["order"]=$order; $racine["amount"]=$amount; $racine["buyer"]=$buyer; $racine["receivers"]=$receivers; $data_string=json_encode($racine); echo '-------- MSG SEND --------'.$data_string.''; $url=$ApiUrl."/transaction/bill"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL , 'http://sandbox- abyster.appspot.com/rest/api/v2/transaction/bill'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string); curl_setopt($ch, CURLOPT_HEADER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, $header); $result = curl_exec($ch); echo ''.'-------- RESULT --------'.$result.''; 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 7/10 Le consumerToken est un token d'authentification à envoyer à chaque appel de service ; il est obtenu par application du MD5 à la chaine résultant de la concaténation des paramètres consumerId, ConsurmerTimestamp et consumerSecret, consumerName ne peut être vide. V-A. Service de paiement d'une commande▲ Appelez le web Service http://sandbox-abyster.appspot.com/rest/api/v2/transaction/bill avec l'entête défini plus haut et les paramètres suivants pour effectuer le paiement correspondant à la commande. Description des paramètres de la requête : Renseigner les Informations sur la commande Renseignez les informations sur la commande comme indiqué sur les lignes suivantes : information sur la commande Sélectionnez 1. 2. 3. //information sur la commande $order["reference"]="V0Y01"; $order["redirectUrl"]='http://localhost/demoshop.com/traitement.php'; Renseigner les informations sur le montant de la commande voir ligne : montant de la commande Sélectionnez 1. 2. 3. $amount["amountTTC"]=$_POST["prix"]; $amount["currency"]="XAF"; $amount["paymentMethod"]="TRANSFERT_MOBILE_MONEY"; Renseigner les informations sur le montant du client voir ligne : information sur le client Sélectionnez 1. 2. 3. 4. 5. //information sur le client $buyer["msisdn"]="00237".$_POST["phone_mobile"]; $buyer["email"]="tatampion@yahoo.fr"; $buyer["name"]=$firstname = $_POST["firstname"]; $buyer["operateur"]="OrangeMoney"; Receivers : o paramètre optionnel. C'est un tableau dont chaque élément contient les informations sur les éventuels destinataires du paiement qui sera reçu. Si le marchand désire que le montant qu'il va recevoir pour un achat soit directement envoyé vers un ou plusieurs bénéficiaires alors il spécifie tout simplement en fournissant les informations nécessaires et le traitement désiré sera effectué à la réception du paiement. Exemple : "receivers": [{"buyer":{"msisdn":"002376666666","email":"tatampion@yahoo.fr"},"amount": {"amountTTC":100,"currency":"XAF","paymentMethod":"TRANSFERT_MOBILE_MONEY"},"description":"destinataire du paiement" }] Description des champs : Paramètres Type Requis Description if (curl_errno($ch)> 0)die('There was a cURL error: ' . curl_error($ch)); else{ curl_close($ch); echo 'data= '; var_dump($result); } $ch1 = curl_init(); curl_setopt($ch1, CURLOPT_URL , 'http://sandbox- abyster.appspot.com/rest/api/v2/transaction/3294/status'); curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch1, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch1, CURLOPT_HEADER, true); curl_setopt($ch1, CURLOPT_HTTPHEADER, $header); $result = curl_exec($ch1); echo "---Statut vente --------".$result; ?> 02/12/2021 16:17 Apprendre à intégrer l'API AByster sur un site marchand https://ntepp-marcus.developpez.com/tutoriels/php/integration-API-AByster/ 8/10 amount Json Object oui Objet json à la structure identique à celle présentée au §Amount,mais ici amountTTC est le montant à envoyer au destinataire buyer Json Object Oui Objet json à la structure identique à celle présentée au §Buyer,mais ici le msisdn et l'e-mail sont ceux du destinataire du paiement et non celui du client Description String Nom Description de la transaction à réaliser Exemple du contenu final avec tous les paramètres contenu final avec un bénéficiaire. Remarque : convertir toutes les informations au format json à l'aide de la fonction php json_encode() Instance d'une requête de paiement Cette partie est la plus importante, elle nécessité votre attention. Le programme php ci-dessus se sert de la bibliothèque pour se connecter au serveur abysterurl en appelant le service web de paiement comme l'indique la ligne 60. si tout se passe bien, vous obtenez la réponse du serveur au format json. Instance de la réponse quand tout s'est bien passé et interprétation Le marchand reçoit en retour l'objet uploads/Finance/ apprendre-a-integrer-l-x27-api-abyster-sur-un-site-marchand 1 .pdf