Logiciel de Pré-paiement

Résumé de l'implantation des 3 modes transactionnels

19 janvier 2004

Le pré-paiement permet de traiter les transactions selon 3 modes distincts :

• Une transaction directe passée au pré-paiement (programme en arrière plan)
• Une transaction qui passe par le fureteur avec le formulaire de saisie de carte de crédit du pré-paiement (via un site web)
• Un lot de transactions téléchargées (via un fichier téléchargé dans l'intranet du pré-paiement).

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)

1. Traitement de transactions directes (programme en arrière plan)

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

1. NoTransaction : Le numéro attribué à la transaction par l'origine.
2. MONTANT : Le montant de la transaction
3. DETENTEUR : Le nom du détenteur
4. CCNUM : Le numéro de carte de crédit
5. ANNEEEXP : L'année d'expiration de la carte de crédit
6. MOISEXP : Le mois d'expiration de la carte de crédit
7. SiteID : L'identificateur du site dans le pré-paiement
8. MarchandID : Le numéro du compte marchand dans le pré-paiement
9. Acheteur : Le nom de l'acheteur.
10. ID : Numéro de vérification de l'origine de la transaction.

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 :

1. StatutID : Le statut de la transaction : 1 Acceptée, 0 : refusée.
2. MSGPublisoft : Si une erreur est survenue à la réception des paramètres d'entrée ou au cours du traitement chez Publisoft.
3. Message : Le message anglais précis retourné par la banque.
4. AuthNumber : Le numéro d'autorisation de la banque.
5. TypeCarte : Le type de carte de crédit employé : Visa, Mastercard, Amex
6. Detenteur : Le nom du détenteur de la carte de crédit.
7. Acheteur : Le nom de l'acheteur, si celui-ci a été passé en paramètre à l'amorce de la transaction.
8. Montant : Le montant de la transaction
9. ReçuTransaction : Le reçu complet de la transaction.
10. Test : Si la transaction est un test : 1 = test, 0 = Réelle.
11. NoTransaction : Le numéro de la transaction.
12. DateHeure : La date et heure de la fin du traitement.
13. SiteID : L'identificateur du site dans le pré-paiement.

Ces valeurs sont passées sous forme de liste séparées par le caractère «^» en réponse à une demande « HTTPPOST ».

1. Traitement de transactions à partir d'un site web externe qui appelle le formulaire de saisie des informations de carte de crédit

1. 1. Les paramètres suivants sont passés de l'origine de la transaction vers le pré-paiement :

1. montantSansTaxe : Le montant de la transaction sans les taxes.
2. Montant : Le montant total net de la transaction avec taxes.
3. TPS : Taxe de vente du Canada
4. TVH :Taxe de vente autres provinces que le Québec.
5. TVQ :Taxe de vente du Québec
6. SiteID : L'identification du site
7. NoTransaction : L'identification unique de la transaction (généré par le client).
8. Langue : La langue d'affichage des données : "_fr" pour le français et "_an" pour l'anglais.
9. MarchandID : L'identification numérique du nom du compte marchand utilisé (donné par l'administrateur du pré-paiement). Ce nom de compte correspond à une devise. (à ne pas confondre avec les numéros des comptes marchand donnés par la banque).
10. Acheteur : Le nom de l'acheteur.
11. ID : Numéro de vérification de l'origine de la transaction.

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 :

• Maximum 16 digits avec un exemple
• Menu déroulant pour la date d'expiration, i.e. mois et année (sauf pour le traitement d'un lot)
• Valide que la date d'expiration n'est pas antérieure à la date du jour
• Type de carte prévalidée selon le premier caractère, i.e. Visa, Mastercard, Amex.
• Le formulaire de demande de carte de crédit est affiché avec la même couleur de fond et le même logo que le site.
• Un logo « Traitement par Publisoft » apparaît sur le formulaire.

1. 1. La confirmation envoyée du pré-paiement vers le traiteur

À 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 :

1. StatutID : Le statut de la transaction (1 = acceptée, 0 = refusée).
2. AuthNumber : Le numéro d'autorisation de la transaction (seulement si le statutID = 1).
3. TypeCarteID : Le type de carte de crédit utilisée ( Visa, Master card, Amex).
4. NoTransaction : Le numéro d'origine de la transaction pour faire l'appariement au retour.
5. SiteID : L'identification de l'origine la transaction.
6. Montant : Le montant chargé sur la carte.
7. RecuTransaction : Le reçu complet de la transaction.
8. Message : Le message anglais précis retourné par la banque
9. Langue : La langue d'affichage des données.
10. Test : Si la transaction est un test : 1 = test, 0 = Réelle.

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  :

• La date et l'heure de l'importation
• Le # de lot qui est généré automatiquement
• Le nombre de transactions importées
• Le montant des transactions importées.

Chaque transaction à l'entrée est validée. Les champs sont :

• Le numéro de la transaction
• Le numéro de la carte de crédit
• La date d'expiration de la carte (format MM/AA)
• Le nom du détenteur de la carte
• Le montant net de la transaction.

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.

• Le pré-paiement retourne normalement à l'origine des informations concernant le traitement de chaque transaction à l'aide d'une commande <HttpPost>.
• Si l'option du « Hand Shaking » est sélectionnée dans le pré-paiement, une commande < HttpPost > sera envoyée à l'origine pour chacune des transactions à toutes les 5 minutes, tant que le pré-paiement ne recevra pas une réponse « Transaction OK » de l'origine.

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.

1. MarchandIDAmex : L'identification numérique du nom du compte marchand correspondant à une devise canadienne pour attribuer la transaction.
2. Taux : Le taux de change à utiliser dans le cas Amex pour convertir le montant total net en dollars canadiens.

1. ConversionActive : Initialiser à "1" pour activer la conversion Amex. Sinon à « 0 ».

Les champs en caractères gras sont obligatoires.


6.0 Paramètres des paiements récurrents