Vous êtes sur la page 1sur 8

BP 59 Pôle Technologique

El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

Introduction

Le guide pour les commerces recueillit les aspects à prendre en considération par les commerces
souhaitant utiliser le TPE Virtuel (Affiliation) lors de leurs achats à travers Internet.

Ce paquet résume l’ensemble des fonctionnalités que peut offrir notre plateforme aux commerces :
profils opérationnels de fonctionnement, types de demandes d’autorisation, niveau de sécurité des
paiements, etc.

Il expose également les indications techniques nécessaires pour réaliser le branchement du serveur du
commerce au TPE Virtuel, ainsi que d’autres services ajoutés de consultation et d’envoi de transactions
moyennant XML.

En dernier lieu, les options disponibles pour l’application d’administration, qui s’avèrent d’une grande utilité pour la gestion des
commandes du commerce, sont aussi détaillées.

Types de demandes d’autorisation :

En fonction des besoins de chaque commerce, la plateforme offre une large variété de demandes d’autorisation, que le
commerce peut combiner d’après ses nécessités.

 Autorisation:

Il s’agit du cas le plus général où la transaction est commencée par le titulaire, qui est présent pendant son processus.
Une fois le commerce reçoit la demande d’achat, notre plateforme de paiement demande les données au client pour
réaliser la transaction d’autorisation et le redirige vers l’intégrateur concerné (CB, PT et GPPAY).

Le titulaire de la carte reçoit un justificatif du paiement réalisé ainsi que le marchand.

 Autorisation en différé

Elle permet aux commerces virtuels de réaliser une gestion du risque de leurs opérations avant de livrer la commande.
Le commerce dispose de 72 heures, après avoir réalisé l’autorisation en différé, pour la confirmer (toujours pour le
même montant) ou pour l’annuler d’après l’analyse du risque effectué.

La transaction est transparente pour le titulaire qui, à tout moment, agit exactement de la même façon que dans le cas
précédent, c’est-à-dire, il fournit ses données et s’authentifie lui-même le cas échéant, en recevant de la
plateforme le justificatif correspondant.

La transaction ne produit pas des effets comptables sur le compte du titulaire et non plus un crédit au commerce.

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

Toute autorisation en différé doit avoir une “confirmation” ou “annulation” dans un délai maximal de 72
heures. Dans le cas contraire, elle perdra sa validité et le système produira une annulation automatique de la
transaction.

 Confirmation d’autorisation en différé

Elle complète de façon inséparable l’opération précédente.

Le titulaire n’est pas présent, c’est pourquoi elle est toujours initiée par le marchand.

Elle doit être réalisée dans les 72 heures suivant l’autorisation en différée originelle et son montant doit être ÉGAL
à CELUI de l’originelle.

Cette transaction est traitée de manière comptable, régularisant automatiquement l’annotation sur le compte du
titulaire.

La plateforme validera l’existence de l’opération originelle et le montant à confirmer, et refusera l’opération dans
l’hypothèse où elle comprendrait d’erreurs.

 Annulation d’autorisation en différé:

Le titulaire n’est pas présent, c’est pourquoi elle est toujours initiée par le marchand. Elle doit être réalisée dans les 72
heures suivant l’autorisation en différée originelle.

La plateforme validera l’existence de l’opération originelle et refusera l’opération dans l’hypothèse où elle comprendrait
d’erreurs.

 Préautorisation:

NOTE: cette opération est restreinte à certains cas.

Elle peut être utilisée lorsque, au moment de l’achat, son montant exact ne peut pas être déterminé ou, pour une
raison quelconque, le commerce ne souhaite pas débiter le montant sur le compte du client tout de suite.

La transaction est transparente pour le titulaire qui, à tout moment, agit exactement comme dans le cas précédent,
à savoir, il fournit ses données et s’authentifie lui-même.

La demande de préautorisation est réalisée en temps réel et produit une retentions sur le compte du titulaire pour le
montant de la vente.

La transaction n’est pas capturée et, par conséquent, ne produit pas d’effets comptables sur le compte du titulaire et
non plus un crédit au commerce.

 Transaction récurrente:

Elle permet au titulaire de souscrire un service fourni par le marchand.

Le montant total de ce service sera crédité au moyen du paiement d’un nombre déterminé de cotisations.

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

Moyennant cette opération, le marchand communiquera le montant total à payer, le nombre minimal de jours à partir
duquel le paiement de la cotisation suivant peut être effectué ainsi que la date limite du paiement de la dernière
cotisation.

Ensuite, le commerce enverra des transactions successives d’autorisation à l’échéance de chaque cotisation.

Le tableau suivant résume les principales caractéristiques de chaque opération:

Opération originelle
Type d’opération Initiée par Comptable Validations Opération Sure

Lorsque
Autorisation Titulaire OUI conditions
remplies

Confirmation Autorisation Mêmes que


d’autorisation différée Marchand OUI 72 heures et Montant = l’original

Annulation Autorisation Mêmes que


Marchand NON 72 heures et
d’autorisation différée Montant = l’original

Lorsque
Préautorisation Titulaire NON conditions
remplies

Lorsque
Récurrente Titulaire OUI conditions
remplies

Méthode de relier votre site à GPGCheckout

- Cette méthode est destinée aux webmasters qui souhaitent rediriger leurs flux monétique vers notre
interface de paiement. Elle doit être utilisée pour les sites de vente de produits, ou pour les sites de
gestion d'abonnement.

- Créez une page HTML ou PHP sur votre serveur, et insérez le code suivant :

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

<?php
$NumSite = 'XXXXXX';
$Password = 'XXXXXXX';
$Amount = '1250';
$Devise = 'TND';
$orderId = date('ymdHis');
$signture = sha1($NumSite.$Password.$orderId.$Amount.$Devise);
?>
<FORM name="paiment" method="POST" action="https://preprod.gpgcheckout.com/Paiement_test/Validation_paiement.php" >
<input type="hidden" name="NumSite" value="<?php echo $NumSite;?>"><br /><br />
<input type="hidden" name="Password" value="<?php echo md5($Password);?>"><br /><br />
<input type="hidden" name="orderID" value="<?php echo $orderId ;?>"><br /><br />
<input type="hidden" name="Amount" value="<?php echo $Amount;?>"><br /><br />
<input type="hidden" name="Currency" value="<?php echo $Devise;?>"><br /><br />
<input type="hidden" name="Language" value="fr"><br /><br />
<input type="hidden" name="EMAIL" value="contact@gpgcheckout.com"><br /><br />
<input type="hidden" name="CustLastName" value="nom"><br /><br />
<input type="hidden" name="CustFirstName" value="prenom"><br /><br />
<input type="hidden" name="CustAddress" value="ariana"><br /><br />
<input type="hidden" name="CustZIP" value="2080"><br /><br />
<input type="hidden" name="CustCity" value="ariana"><br /><br />
<input type="hidden" name="CustCountry" value="tunisie"><br /><br />
<input type="hidden" name="CustTel" value="26547852"><br /><br />
<input type="hidden" name="PayementType" value="1"><br /><br />
<input type="hidden" name="MerchandSession" value=""><br /><br />
<input type="hidden" name="orderProducts" value="2* jeans(Rouge,L) , 2*Robe(Noir,XL)"><br /><br />
<input type="hidden" name="signature" value="<?php echo $signture;?>"><br /><br />
<input type="hidden" name="AmountSecond" value=""><br /><br />
<input type="hidden" name="vad" value="345566666"><br /><br />
<input type="hidden" name="Terminal" value="002"><br /><br />
<input type="hidden" name="TauxConversion" value=" "><br /><br />
<input type="hidden" name="BatchNumber" value=" "><br /><br />
<input type="hidden" name="MerchantReference" value=" "><br /><br />

<input type="hidden" name="Reccu_Num" value=""><br /><br />


<input type="hidden" name="Reccu_ExpiryDate " value=""><br /><br />
<input type="hidden" name="Reccu_Frecuency " value=" "><br /><br />

<input type="submit" name= "Valider" value="Valider" >


</FORM>

Remarque :
Après la finalisation des différents tests et pour le passage en mode production il faut changer le lien
suivant :
https://preprod.gpgcheckout.com/Paiement_test/Validation_paiement.php
Par le lien suivant :
https://www.gpgcheckout.com/Paiement/Validation_paiement.php

Descriptive des variables de POST Le nom des POST Type des champs
Nom du site (communiqué par GPG) NumSite AN(20) O

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

Mot de passe du site (communiqué par GPG Crypter en


Password AN(64) O
md5)
Numéro de la commande envoyé par votre site. orderID AN(64) O
Email de l’utilisateur EMAIL AN(128) O
Nom de l’utilisateur CustLastName AN(100) O
Prénom de l’utilisateur CustFirstName AN(100) O
Adresse de l’utilisateur CustAddress AN O
Code postal de l’utilisateur CustZIP N(5) F
Ville de l’utilisateur CustCity AN(50) F
Pays de l’utilisateur CustCountry AN(50) F
Téléphone de l’utilisateur CustTel AN(32) O
La langue du site qui prend l’une de ces valeurs
Langue AN(2) O
(fr, en)
Montant total de la commande en millimes avec
Amount N(11) O
la devise TND
Montant total de la commande en devise étrangère (exp:
AmountSecond N(11) F
50 EUR => 5000 EUR)
La devise de la transaction qui prend l’une de
Currency AN(3) O
ces valeurs (TND, EUR, USD)
Type de paiement prend l’une de ces valeurs : PayementType N(1) O
'1'=>Paiement Direct (En une seule fois),
'2'=>Paiement récurent (En plusieurs fois),
'3'=>Paiement différer (Différé),
'4'=>Paiement Pré-autorisation,
'5'=>Paiement Pré-autorisation Confirmation,
'6'=>Paiement Abonnement (Annuel)
Le nombre de récurrence à utiliser uniquement si le Reccu_Num N(2) F
PaymentType est “2”
'2'=> En 2 fois
'3'=> En 3 fois
'6'=> En 6 fois
Le nombre de récurrence à utiliser uniquement si le
PaymentType est “6”
'12'=> Abonnement (annuel) En 12 fois
Le délai de récurrence à utiliser chaque X fois en jours Reccu_Frecuency N(3) F
Fréquence en jours pour les transactions récurrentes et
récurrentes différées (obligatoire pour les récurrentes)
Exp : 30 (jour)
Date Limite sous le format aaaa-MM-jj date limite pour Reccu_ExpiryDate AN(10) F
transactions Récurrentes (Obligatoire pour les récurrentes et
récurrentes différé)
Description de la commande, affichée lors du paiement
orderProducts AN O
longueur libre

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

Variable de session du site marchand, restitué au retour


après paiement pour permettre une récupération du merchandSession AN(254) F
contexte session utilisateur sur le site marchand

calculer selon cette formule :


signature AN(255) O
sha1(NumSite+Password+orderId+Amount+devie )

Code VAD communiqué par GPG vad AN(11) F

Identifiant terminal communiqué par GPG Terminal N(5) F

Valeur de conversion utilisée au niveau du site marchand TauxConversion Float F


Détails ou les identifiants des Deals (ce champ est propre
BatchNumber AN(64) F
aux sites des deals)
Détails ou les identifiants des fournisseurs MerchantReference AN(64) F

* F : Facultatif / O : Obligatoire

NB : La valeur du champ « TauxConversion » est utilisé dans le cas du paiement international dans le cas
contraire ce champ peut contenir « 1 » ou sans renseignements.

En mode internationale, la valeur du champ «AmountSecond » contiendra le prix initial de la commande


avant son convertissement en TND

EXP: 5000 EUR => 100 000 TND

Notification en ligne :

- Des informations seront poster sur votre site a l’aide de la commande ‘curl’ sur une adresse de votre
choix et par défaut elle sera « paiement_process.php »

Dés que le client vient sur gpgcheckout à partir du site commerçant une notification sera envoyée avec
les informations suivantes :

- En cas d’un paiement avec succès une autre notification sera envoyée avec les informations suivantes :
 TransStatus =>’00 ‘
 PAYID => numéro de la commande envoyée par votre site
 Signature => sha1 (TransStatus+PAYID+Password)

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

-En cas dun paiement Refusé, une autre notification sera envoyée avec les informations suivantes :

 TransStatus=>’05’
 PAYID=>numéro de la commande envoyée par votre site
 Signature => sha1(TransStatus+PAYID+Password)

-En cas d’un paiement annulé, une autre notification sera envoyée avec les informations suivantes :

 TransStatus=>’06’
 PAYID=>numéro de la commande envoyée par votre site
 Signature => sha1(TransStatus+PAYID+Password)

-En cas d’un paiement Remboursé, une autre notification sera envoyée avec les informations suivantes :

 TransStatus=>’07’
 PAYID=>numéro de la commande envoyée par votre site
 Signature => sha1(TransStatus+PAYID+Password)

-En cas d’un paiement ChargeBack, une autre notification sera envoyée avec les informations suivantes :

 TransStatus=>’08’
 PAYID=>numéro de la commande envoyée par votre site
 Signature => sha1(TransStatus+PAYID+Password)

-Autres variables de retour :


Descriptive des variables de POST Le nom des POST
Email de l’utilisateur EMAIL
Nom de l’utilisateur CustLastName
Prénom de l’utilisateur CustFirstName
Adresse de l’utilisateur CustAddress
Téléphone de l’utilisateur CustTel
Montant total de la commande en centime TotalAmount

La devise de la transaction Currency

Description de la commande, affichée lors du paiement longueur libre orderProducts

Type de paiement PayementType


Variable de session du site marchand, restitué au retour après paiement merchandSession
pour permettre une récupération du contexte session utilisateur sur le site
marchand

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com
BP 59 Pôle Technologique
El Ghazela 2088
Tél. : +216 71 857 285
contact@gpgateway.com

URL OK et URL KO :

Pressier l’adresse sur laquelle vous souhaitez que le client soit renvoyé avec paiement avec succès et
sans succès.

Exemple : urlok.php ou urlko.php

Lors de la connexion avec la plateforme GPGCheckout, en cas d’erreur voilà les codes d’erreur qui peuvent
s’afficher dans ce tableau :

Code d’erreur Descriptive des erreurs


"001" Signature non valide
"002" Format Id command non valide
"003" Format montant non valide
"0030" Montant différent du montant déjà reçue de la commande
"004" Format devise invalide
"005" Type paiement invalide
"006" Répétition commande
"007" Paramètre de connexion invalide
"008" Site non inscris
"009" Erreur lors de l'enregistrement de la commande contacter le service gpgcheckout
"010" Commande déjà payé
"011" Affiliation non affecté
"012" Le champ OrderId n’est pas renseigné
"019" Vérifier votre commande, contacter le service gpgcheckout
"02100" Terminal non affecté
"022" Erreur lors de l'enregistrement du paiement contacter le service gpgcheckout
"070" Site marchand Désactiver (État, État de production)
"0210" Vad incorrect ‘Vérifier le code VAD’
"005" Type payement invalide
"209" Paramètres Invalides

S.A au capital de 1 500.000dt


RC : B24168152009 - MF : 1122426/H/M/A/000 - BNA Bank : 03135120011500588667 - www.gpgateway.com