Version Dernière mise à jour Page

1.2 22/05/2018 1/4

PAYMEE
Passerelle de Paiement par Paymee

La Passerelle de Paiement par Paymee (PPP) est facile à intégrer sur un site web.

1. Parcours client
Une transaction Paymee se déroule comme suit :

1. Sur la page web du vendeur sur laquelle le produit ou le service peut être acheté, l'acheteur
clique sur le bouton Acheter.
2. Il est redirigé sur le site Paymee où il s'identifie pour utiliser son compte Paymee.
3. Une nouvelle page Paymee affiche un récapitulatif ; l'acheteur confirme ou annule sa
commande.
Une fois le paiement validé, le site Paymee redirige l’acheteur vers le site marchand.

Site marchand

Acheter

Paymee.tn

Se connecter

Paymee.tn

Marchand : xxxx
Montant : xx,xx DT

Payer

Site marchand

Commande validée

Auteur : Marwen Amamou | Documentation Passerelle de Paiement Paymee

 Version Dernière mise à jour Page
1.2 22/05/2018 2/4
PAYMEE
Passerelle de Paiement par Paymee

2. Intégration du module de paiement

2.1. Flux des données

On distingue 3 étapes principales dans les échanges entre le site marchand et Paymee :
a. Initialisation du paiement : étapes 2 et 3
Cette étape est transparente pour l’acheteur.
Le site marchand demande l’initialisation d’un nouveau paiement en envoyant :
 Identifiant Paymee du vendeur
 Montant de la commande
 Description (champ libre)
API Paymee initialise le paiement et revoie un jeton identifiant le paiement. Le jeton expire à
la fin de la session de l’utilisateur.

URI (TEST) http://18.197.40.155/api/OPRequest/

URI (PROD) https://app.paymee.tn/api/OPRequest/
Méthode POST
Authentification Clé API
Type des données d’entrée JSON
Données d’entrée vendor : identifiant du vendeur Integer
buyer : identifiant de l’acheteur integer
amount : montant de la commande float
description : description de la commande string (optionnel)
Type des données de sortie JSON
Données de sortie token : jeton identifiant le paiement string

b. Paiement avec la passerelle Paymee : étape 4 et 5

Le site marchand redirige l’acheteur vers le serveur Paymee.
URL (TEST) : http://18.197.40.155/gateway/
URL (PROD) : https://app.paymee.tn/gateway/

Auteur : Marwen Amamou | Documentation Passerelle de Paiement Paymee

 Version Dernière mise à jour Page
1.2 22/05/2018 3/4
PAYMEE
Passerelle de Paiement par Paymee

Des données sont envoyées par POST lors de la redirection :

 payment_token : le jeton d’identification du paiement
 url_ok : l’url à laquelle rediriger l’acheteur après la validation du paiement
 url_ko : l’url à laquelle rediriger l’acheteur en cas d’échec de paiement

<form method="post" action="https://app.paymee.tn/gateway/">

<input type="hidden" name="payment_token" value="5d41404b2a76b9719c592">
<input type="hidden" name="url_ok" value="http://marchand.com/ok.php">
<input type="hidden" name="url_ko" value="http://marchand.com/ko.php">
<button>Payer</button>
</form>

Exemple
L’acheteur se connecte et consulte le récapitulatif de la commande. Il valide ou annule le
paiement.
Si l’acheteur valide le paiement, il est redirigé vers l’url indiquée dans « url_ok ».
Si l’acheteur annule le paiement, il est redirigé vers l’url indiquée dans « url_ko ».

c. Vérification du paiement : étapes 6 et 7

Il s’agit d’une étape de sécurité afin de garantir la réalisation du paiement. Cette étape est
transparente pour l’acheteur.
Le site marchand appelle l’API Paymee en envoyant le jeton du paiement. L’API renvoie le
résultat de la vérification.

URI (TEST) http://18.197.40.155/api/OPCheck/

URI (PROD) https://app.paymee.tn/api/OPCheck/
Méthode POST
Authentification Clé API
Type des données d’entrée JSON
Données d’entrée token : jeton identifiant le paiement string

Auteur : Marwen Amamou | Documentation Passerelle de Paiement Paymee

 Version Dernière mise à jour Page
1.2 22/05/2018 4/4
PAYMEE
Passerelle de Paiement par Paymee

Type des données de sortie JSON

Données de sortie resultat : 0 si le paiement n’est pas valide number
resultat : 1 si le paiement est valide

Auteur : Marwen Amamou | Documentation Passerelle de Paiement Paymee