Académique Documents
Professionnel Documents
Culture Documents
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.
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).
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.
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.
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.
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:
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:
Le montant total de ce service sera crédité au moyen du paiement d’un nombre déterminé de cotisations.
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.
Opération originelle
Type d’opération Initiée par Comptable Validations Opération Sure
Lorsque
Autorisation Titulaire OUI conditions
remplies
Lorsque
Préautorisation Titulaire NON conditions
remplies
Lorsque
Récurrente Titulaire OUI conditions
remplies
- 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 :
<?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 />
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
* 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.
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)
-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)
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.
Lors de la connexion avec la plateforme GPGCheckout, en cas d’erreur voilà les codes d’erreur qui peuvent
s’afficher dans ce tableau :