MENU undefined
undefined
s html java php
Copyright Adwa

Introduction

Bienvenue sur AdwaPay. La pésente documentation a pour but de présenter l’intégration d’Adwapay sur une application marchande. Il guide les développeurs dans l’utilisation de l’Api.

Présentation

Environnement de Test : http://test.adwapay.com/service/

AdwaPay est une plateforme de paiement qui vous permet d'integer plusieurs moyens de paiement. A ce jour, les moyens de paiement MTN MOBILE-MONEY et ORANGE-MONEY y sont disponibles. Les moyens de paiement à venir sont UBA pour les cartes bleus et EXPRESS-UNIION MOBILE.

Les transactions sur AdwaPay sont sécurisées par des organismes internationaux à l’instar de DIGICERT et assurées à une valeur maximale de 1 500 000 $ soit 825 000 000 XAF par unité.

Enregistrement Marchand

Element
1 Le code application marchande (obligatoire)
2 Le lien d’appel d’un service web de fin de transaction (optionnel)
3 Le lien de retour après une transaction terminée correctement (obligatoire)
4 Pour un souci poussé de personnalisation, le visuel de l’application marchande (facultatif)

Les différents environnements d’utilisation d’ADWAPAY sont

Environnement de TEST http://test.adwapay.com/service/ qui permet d’effectuer les tests de fonctionnalité.

Environnement de PRODUCTION. Cet environnement est fourni après que les tests sont effectués avec succès.

Services Web

* Exemple d’appel :

POST http://test.adwapay.com/service/buyByPaymentMethod






    
    
Résultat : 


    
                    
                        
URL :"http://test.adwapay.com/service/checkPaymentState"
BUT :Obtenir l’état d’une transaction
                    
                




  	
    
Résultat : 



    
Redirection vers ADWAPAY : Exemple de code java

int dbt = link.indexOf("?");

baseLink = link.substring(0, dbt);

parameterLink = link.substring(dbt + 1, link.length());

parameterLink = parameterLink + "&o=" + totalAmount + "&t=" + phone + "&f=";

parameterLink += serverFooPrint + "&i=" + paymentId + "&u=" + getDataManager().getPersonFromPrefs().getEmail() +"&d=" + paymentMeanORM.getPayementMean();

parameterLink = Base64.encodeToString(parameterLink.getBytes(), Base64.DEFAULT);

baseLink += "?p=" + parameterLink;

De manière générale, les paramètres sont au format JSON (JavaScript Object Notation) et chiffrés. Dans l’environnement de Test, l’algorithme de chiffrement / déchiffrement est base64.

L’intégration complète de l’API passe par l’appel des 3 services web ci-dessous : Le service de paiement

LIEN : http://test.adwapay.com/service/buyByPaymentMethod

Paramètres :

Parametre Type Obligatoire Description
applicationCode String OUI Nom de lapplication appelante enregistre à la création
paymentCode String OUI Code du moyen de payement : MOBILE-MONEY, ORANGE-MONEY, PAYPAL
paymentValue string OUI Numéro de telephone
paymentId String OUI
amount String OUI Montant a Payer

Parametre Type Description
Error String Code réponse de la requête. Valeurs possibles :
- false : pas d’erreur
- true : erreur survenue
Value Json Contient l'\object qui portera la reponse
Link{link} String URL de chargement de Adwapay
redirecLinkt String URL de redirection du marchand apres le paiement
serverFootPrint String Clé qui identifie la session cliente.

Redirection vers ADWAPAY

Rediriger votre site web sur ADWAPAY à partir du link (url) de la réponse.

Une fois le lien composé, y rediriger votre site.

Ci-dessous une illustration d’une page ADWAPAY, où il est demandé au client de faire un transfert vers un numéro :

Le client Clique sur le bouton continuer après avoir transférer le montant demandé.

Après cela, si le service web de confirmation de transaction a été configuré, ADWAPAY informe du statut de la requête à l’application.

Et dans le cas où la transaction a été clôturée avec succès, le client est automatiquement renvoyé vers le lien de redirection préalablement configuré.


Parametre Type Description
Error String Code réponse de la requête. Valeurs possible : false : pas d’erreur true : erreur survenue
Value Json Contient l’objet qui portera la réponse.
Statut String Etat de la transaction ; T=Terminée, G=Générée, A=En attente de paiement, O=Echec opérateur.