Vortex Solution40 Rue Jean-Talon Est Soutien techniqueTéléphone : 514 278-7575 Heures d'ouverture : |
19 janvier 2004
Le pré-paiement permet de traiter les transactions selon 3 modes distincts :
Dans les pages qui suivent, nous référons à « l'origine » comme étant la source de la transaction, peu importe le mode de transaction utilisé.
La partie publique et l'intranet de gestion fonctionnent avec les versions de navigateurs IE et Netscape 4.0 et +. Les prérequis qui doivent être activés dans la configuration du logiciel de navigation pour la partie publique sont : les cookies, les stylesheets et le javascript. Les prérequis qui doivent être activés dans la configuration du logiciel de navigation pour pour l'intranet de gestion sont les mêmes plus les frames.
L'interface pour la gestion du logiciel est en français et en anglais. Le logiciel supporte les sites en trois langues (français, anglais et aussi dans une troisième langue). Dans tout le logiciel, lorsqu'il y a un message, celui-ci peut être disponible dans 3 langues.
Le schéma général de fonctionnement du traitement est le suivant. Le traitement permet à l'origine de la transaction, optionnellement, de recevoir le statut de chacune des transactions traitées.
Définition et format des champs utilisés :
ANNEEEXP : L'année d'expiration de la carte de crédit en format AA.
AuthNumber : Le numéro d'autorisation de la banque. (8 caractères numériques)
CCNUM : Le numéro de carte de crédit, sans espace. (16 caractères numériques)
DETENTEUR : Le nom complet du détenteur, sans accent. (Alpha numérique 30)
Langue : La langue d'affichage des données : "_fr" pour le français et "_an" pour l'anglais.
MarchandID : Le numéro du compte marchand.(numérique)
MarchandIDAmex : Le numéro du compte marchand Canadien pour le traitement Amex en devise US. (numérique)
MOISEXP : Le mois d'expiration de la carte de crédit en format MM.
MONTANT : Le montant de la transaction, les 2 décimales séparées par un « . », sans séparateur de milliers.
NoTransaction : Le numéro attribué à la transaction par l'origine. (20 caractères numériques)
SiteID : L'identificateur du site dans le pré-paiement. (numérique)
Ce mode permet l'acceptation de transactions directes (sans utilisation d'un formulaire ou de lots).
1.1 Les paramètres sont passés de l'origine au pré-paiement
Plus, les 3 paramètres si la carte Amex en devise US est utilisée (voir section 5.0)
Les champs en caractères gras sont obligatoires.
L'adresse pour traiter directement une transaction est la suivante :
https://www.paiementuni.com/UQAM/TrxDirect/in.cfm
ou dans le cas d'un client autre que l'UQAM
https://www.paiementuni.com/paiement/TrxDirect/in.cfm
1.2 Les paramètres de retour passés du pré-paiement à l'origine des transactions sont :
Ces valeurs sont passées sous forme de liste séparées par le caractère «^» en réponse à une demande « HTTPPOST ».
Plus, les 3 paramètres si la carte Amex en devise US est utilisée (voir section 5.0)
Les champs en caractères gras sont obligatoires.
L'adresse pour accéder au formulaire de saisie de carte de crédit du Pré-paiement est la suivante :
https://www.paiementuni.com/UQAM/cc/cc-form.cfm
ou dans le cas d'un client autre que l'UQAM
https://www.paiementuni.com/paiement/cc/cc-form.cfm
HTTPS :
L'utilisation complète du logiciel du pré-paiement et du formulaire de saisie de cartes de crédit est complètement sécurisée (HTTPS). Le certificat utilisé est celui de Publisoft. Le logo du certificat d'encryption est cliquable pour fin d'authentification dans le formulaire de saisie de la carte de crédit. Aussi, au niveau de la prise de commande, chaque site peut posséder son propre certificat d'encryption et d'authentification avant et après le pré-paiement. L'intranet du pré-paiement sera au complet en HTTPS.
2.2 La validation à la saisie par le pré-paiement
Le logiciel du pré-paiement valide le contenu du formulaire de saisie de la carte de crédit pour éviter des frais de transactions inutiles. Il affiche au besoin un message intelligible en Javascipt :
À l'envoi du formulaire vers le traiteur, on affiche un message « SVP, veuillez patienter quelques instants pour recevoir la confirmation du paiement. »
Si le paiement est refusé 3 fois par le traiteur, on affiche le message de refus avec le URL de retour.
Le logiciel valide que le paiement d'une transaction est soumis une seule fois au traiteur. Si un numéro de transaction (préfixe du site suivi du numéro provenant de l'origine) a déjà été autorisé, il ne peut être soumis une seconde fois.
2.4 Le retour du pré-paiement à l'origine de la transaction
Après le traitement, les paramètres que l'on retourne au site d'origine sont les suivants :
Le logiciel du pré-paiement permet de retourner à l'origine selon plusieurs URL. Ceci permet de traiter des sites identiques localisés avec des noms de domaines différents (sites miroirs).
3.0 Le traitement de transactions passées en lot par un fichier
Le logiciel permet d'importer un lot de transactions provenant de l'usager d'un site dans le pré-paiement. Les transactions sont entrées par le téléchargement d'un fichier. Le déclenchement du traitement de ces transactions est effectué automatiquement. Les données des cartes de crédit sont détruites immédiatement après le traitement.
Un rapport d'importation est produit immédiatement après le traitement avec les informations suivantes :
Chaque transaction à l'entrée est validée. Les champs sont :
Plus, les 3 paramètres si la carte Amex en devise US est utilisée (voir section 5.0)
Chaque paramètre d'une transaction est séparé par un caractère « ; » et chaque enregistrement se termine par un retour de chariot (« Return » ou « Enter »). L'ordre indiqué doit être scrupuleusement respecté.
Exemple de fichier :
1;4111111111111111;03/03;Mathieu Corbeil;1.50
2;4111111111111111;03/03;Nicolas Ouimet;2.50
3;4111111111111111;03/03;Yannick Gauthier;3.50
4;4111111551111111;03/03;Philippe Lord;4.50
5;4111111111111111;03/03;Guillaume Forest;5.50
Lorsque le lot est correctement transféré, le traitement des transactions est automatiquement déclenché. À la fin du traitement, un message apparaît à l'écran et donne le nombre de transactions traitées.
Si le lot n'a pas été complètement traité, un bouton « redémarrer » est affiché et il suffit de le cliquer pour continuer le traitement des transactions. Une transaction n'est traitée qu'une seule fois seulement.
Pour des raisons de sécurité, un usager ne peut traiter plus d'un lot à la fois pour un site donné.
4.0 Réception des paramètres de confirmation (Hand Shaking) par le pré-paiement
Cette fonction est utilisée si le site d'origine dans le pré-paiement est configuré pour effectuer une vérification de réception du statut de la transaction (Hand Shaking). Si c'est le cas, le processus est le suivant :
Le pré-paiement arrêtera d'émettre une commande de <Hand Shaking> si la séquence « Transaction OK » est reçue de l'origine par le pré-paiement.
Note : Le site d'origine a la possibilité de lire en temps réel la réponse du <HttpPost> soumise en 1-1, afin de rendre la transaction synchrone. Si c'est la méthode adoptée par le client et que celui-ci active en plus le « Hand Shaking », le site d'origine devra prévoir la réception d'une commande <HttpPost> additionnelle.
Cette fonction est disponible pour les 3 modes de transaction,
5.0 Paramètres et traitement si l'origine des transactions accepte les cartes AMEX en devise US (optionnel):
Tous les paramètres ci-dessous sont requis seulement si l'origine des transactions traite des prix en devise US et donc désire traiter une transaction en devise US avec la carte de crédit AMEX. En tout temps, le site doit passer les paramètres de façon à ce que le pré-paiement traite correctement les cartes AMEX. 2 cas peuvent se produire : a) Il existe un numéro de compte marchand US pour AMEX. Le paramètre « conversionactive » sera à « 0 ». La transaction sera attribuée au compte US correspondant au paramètre MarchandID. b) Il n'existe pas de numéro de compte marchand US pour AMEX . La transaction sera alors convertie selon le taux et attribuée au compte marchand Canadien correspondant au paramètre MarchandIDAmex.
Les champs en caractères gras sont obligatoires.
6.0 Paramètres des paiements récurrents
Variables à passer via l'URL | ||||
Nom de la variable | Description | Valeurs possibles | ||
rt | Récurrence Type | D = Quotidienne | ||
rf | Récurrence Fin | Un nombre | ||
rfp | Récurrence Fin Période | D = Jours | ||
Exemple : | ||||
Autres variables | Description | |||
SiteID |
| |||
MarchandID | ||||
Langue | ||||
Montant | ||||
NoTransaction | ||||
montantSansTaxe | ||||
TPS | ||||
TVH | ||||
TVP | ||||
MarchandIDAmex | ||||
Taux | ||||
NoFacture |