Guide de configuration

Configuration du Centre de ressources pour commerçants

L'outil de configuration de la transformation en jetons hébergée, offert dans le Centre de ressources pour commerçants (CRC), sert à créer et à gérer le profil de la solution de paiement hébergée. La création et la configuration de ce profil constituent les deux premières étapes de l'intégration de la transformation en jetons hébergée au système du commerçant.

Suivre les étapes ci-dessous pour configurer le Centre de ressources pour commerçants.

Obtention d'un jeton temporaire

Pour obtenir un jeton temporaire, transmettre une demande à Moneris à partir d'un cadre en ligne (iframe). Dans l'exemple ci-dessous, remplacer ${profileID} par le Profile ID obtenu au moment de la configuration du Centre de ressources pour commerçants.

Configuration

<iframe 
  id="monerisFrame"
  src="https://esqa.moneris.com/HPPtoken/index.php?
    id=${profileID}&
    pmmsg=true&
    enable_exp=1&
    enable_cvd=1&
    display_labels=1"
  style="border: 0;"
  width="200"
  height="200">
</iframe>

<input type="button" onclick="doMonerisSubmit()" value="Submit iframe request">

Demande

Mettre en œuvre la fonction qui transmet la demande de transformation en jetons à partir du cadre en ligne (iframe).

function doMonerisSubmit() {
  const monerisFrame = document.getElementById("monerisFrame");
  const monerisFrameWindow = monerisFrame?.contentWindow;

  if (!monerisFrameWindow) {
    return false;
  }

  monerisFrameWindow.postMessage("tokenize", "https://esqa.moneris.com");
}

Réponse

La réponse est un objet JSON qui comprend les quatre champs suivants :

Exemples

{
  "dataKey": "ot-tAZSNHEDV4t4Rn6bonrripHm4",
  "bin": "545454",
  "responseCode": "001"
}

{
  "dataKey": "ot-tAZSNHEDV4t4Rn6bonrripHm4",
  "bin": "545454",
  "responseCode": [ "001" ]
}

{
  "errorMessage": "invalid data",
  "responseCode": [ "943" ]
}

{
  "errorMessage": "invalid data",
  "responseCode": [ "945", "943", "944" ]
}

Traitement d'un paiement au moyen du jeton temporaire

Transmission du jeton temporaire

Pour porter un montant à la carte au moyen du jeton temporaire, transmettre le jeton à une page du site qui met en œuvre l'API de la voûte de Moneris. Il faut d'abord lire le jeton dans la réponse de l'iframe en ajoutant un écouteur d'événement de message.

const monerisDomain = "https://esqa.moneris.com"; // Utiliser "https://www3.moneris.com" en production

window.addEventListener("message", function(event) {
  // Contrôle de sécurité : seuls les messages provenant du domaine Moneris de confiance sont acceptés.
  if (event.origin !== monerisDomain) return;

  try {
    const response = typeof event.data === "string" ? JSON.parse(event.data) : event.data;
    const responseCodes = Array.isArray(response.responseCode)
      ? response.responseCode
      : [response.responseCode];

    // Traitement d'une réponse positive :
    if (responseCodes.includes("001")) {
      // dataKey est le jeton temporaire qui représente le numéro de carte.
      const dataKey = response.dataKey;

      // Transmettre le jeton à la page de traitement des paiements.
      processPayment(dataKey);
    } else {
      // Traitement des erreurs de validation
      console.log(
        "Credit card validation failed with Moneris response code(s): " + responseCodes.join(", ")
      );
    }
  } catch (error) {
    console.error("Failed to parse message from Moneris.", error);
  }
});

Traitement du paiement

Pour porter un montant à la carte au moyen du jeton temporaire, transmettre le jeton à une page qui met en œuvre l'API de la voûte de Moneris. La voûte permet aux commerçants de créer des profils de clients, de les modifier et de les utiliser pour traiter des transactions sans avoir à saisir de nouveau les renseignements financiers. Les profils de clients contiennent les données essentielles au traitement des transactions. La voûte prend en charge deux types de transactions : administratives et financières.

• Transactions administratives : ces transactions servent à gérer les profils de paiement conservés dans la voûte et n'entraînent aucun mouvement de fonds. Elles servent à tenir à jour les renseignements de paiement des clients, notamment lors de la transformation en jetons et de la gestion des profils. La clé de données ainsi obtenue est ensuite utilisée pour le traitement des paiements.
• Transactions financières : ces transactions utilisent la clé de données conservée dans la voûte pour traiter les paiements et entraînent le mouvement ou l'autorisation de fonds. Comme elles s'appuient sur les données de carte transformées en jetons, il n'est pas nécessaire de soumettre de nouveau les renseignements de carte, ce qui facilite le respect de la conformité PCI.

Pour en savoir plus sur l'API de la voûte, consulter la documentation de l'API de la voûte. Voici des exemples de transactions pouvant être effectuées avec le jeton :

• Achat avec la voûte (API | Lot)
• Préautorisation avec la voûte (API | Lot)
• Vérification de carte avec la voûte (API)
• Ajout d'un jeton dans la voûte (API)

Mise à l'essai de la solution de paiement hébergée

Marche à suivre pour les essais

Un environnement d'essai est offert pendant l'intégration du site à la passerelle Moneris. Cet environnement est accessible en tout temps; toutefois, comme il s'agit d'un environnement de développement, sa disponibilité n'est pas garantie à 100 %. D'autres commerçants l'utilisent également : il est donc possible d'y voir des transactions, des identifiants d'utilisateur et des configurations de transformation en jetons hébergée créés par des tiers.

Par courtoisie envers les autres utilisateurs, n'utiliser que les transactions, les utilisateurs et les configurations créés par soi-même pour effectuer des remboursements, modifier des mots de passe ou mettre à l'essai d'autres fonctions.

L'environnement d'essai reproduit le plus fidèlement possible le comportement de l'environnement de production. Il s'en distingue toutefois sur un point important : les transactions d'essai ne sont pas transmises au réseau d'autorisation réel, et les réponses des émetteurs sont donc simulées. Pour reproduire les scénarios d'approbation, de refus et d'erreur, certaines variables de transaction doivent contenir des valeurs précises.

Dans l'environnement d'essai, l'approbation ou le refus dépend des cents indiqués dans le champ du montant. Par exemple, les transactions de 9,00 $ ou de 1,00 $ sont approuvées, puisque la valeur .00 correspond à une réponse d'approbation. Les transactions effectuées dans l'environnement d'essai ne doivent pas dépasser 10,00 $. Cette limite ne s'applique pas en production.

Cartes d'essai

Lors des essais, il est possible d'utiliser les numéros de carte suivants, avec n'importe quelle date d'expiration à venir.

Numéros de carte d'essai

Passage en production

Une fois le profil créé et configuré et les travaux de développement et d'essai terminés, la solution peut être déployée en production.

Configurer un magasin pour la production

Une fois le magasin activé, l'étape suivante consiste à le diriger vers l'hôte de production :

1. Remplacer l'adresse indiquée dans l'attribut action du formulaire HTML, soit celle de l'environnement d'essai (https://esqa.moneris.com/HPPtoken/index.php), par celle de l'environnement de production (https://www3.moneris.com/HPPtoken/index.php).
2. Remplacer la valeur de profile_id par le Profile ID de production.

En production, accéder au Centre de ressources pour commerçants à l'adresse https://www3.moneris.com/mpg. Utiliser l'identifiant d'administrateur du magasin créé au moment de l'activation, puis créer les autres utilisateurs requis.

Considérations relatives à la conformité

Les exigences de la norme PCI DSS peuvent varier selon l'intégration de paiement et sa mise en œuvre. Examiner les exigences de conformité applicables à l'entreprise avant le passage en production. Pour en savoir plus, consulter la page Conformité.