Codes de réponse d’erreur

Vue d'ensemble

L’annexe suivante contient des informations sur les codes de réponse d’erreur et comment traiter certains types d’erreurs.

Remarque : Ces codes d’erreur s’appliquent uniquement au champ de réponse errorCode (code d’erreur).

Code d'erreur '5906' (Intégration Cloud uniquement)

Le code ‘5906’ est généré lorsque la connexion du terminal aux serveurs de Moneris a été interrompue pendant une transaction. Ce code est produit lorsque le serveur détecte que la connexion avec le pinpad a été rompue en raison d’un manque de signaux de maintien de session au niveau applicatif.

{
   "receipt":{
      "apiVersion":"3.0",
      "statusCode":"5476",
      "status":"Communication error",
      "dataId":"example_dataId",
      "dataTimestamp":"1969-12-31 23:59:59",
      "data":{
         "response":[
            {
               "idempotencyKey":"example_idempotencyKey",
               "orderId":"example_orderId",
               "statusCode":"5476",
               "status":"Communication error",
               "cloudTicket":"example_cloudTicket",
               "linkId":"example_linkId",
               "terminalId":"example_terminalId",
               "errorDetails":[
                  {
                     "errorCode":"5906",
                     "issue":"Pinpad connection has timed out"
                  }
               ],
               "completed":"true"
            }
         ]
      }
   }
}

Code d’erreur ‘5907’ (Intégration Cloud uniquement)

Le code ‘5907’ est généré lorsque les journaux de connexion signalent une erreur réseau (par exemple EPIPE ou ECONNRESET).

{
   "receipt":{
      "apiVersion":"3.0",
      "statusCode":"5476",
      "status":"Communication error",
      "dataId":"example_dataId",
      "dataTimestamp":"1969-12-31 23:59:59",
      "data":{
         "response":[
            {
               "idempotencyKey":"example_idempotencyKey",
               "orderId":"example_orderId",
               "statusCode":"5476",
               "status":"Communication error",
               "cloudTicket":"example_cloudTicket",
               "linkId":"example_linkId",
               "terminalId":"example_terminalId",
               "errorDetails":[
                  {
                     "errorCode":"5907",
                     "issue":"Pinpad was disconnected during a transaction"
                  }
               ],
               "completed":"true"
            }
         ]
      }
   }
}

Gestion des erreurs

Erreur de communication – ‘5906’ et ‘5907’

Lorsque ces deux réponses sont reçues, cela peut indiquer soit une déconnexion momentanée causée par une perte de connexion Wi-Fi ou cellulaire, soit une panne réseau, soit un problème sur le réseau du commerçant, soit une interruption sur l’Internet public.

Dans les deux cas d’erreur, Moneris recommande que le commerçant renvoie la même transaction pour tenter de récupérer la précédente. Le terminal met en mémoire tampon le reçu final si la transaction a été traitée avec succès.

Si ces réponses sont causées par une panne réseau, on s’attend à ce que le commerçant reçoive de nombreux messages de type “impossible de localiser le pinpad”. Dans ce cas, les tentatives de renvoi doivent être faites toutes les 30 secondes pendant un maximum de 5 minutes. Si plusieurs appareils rencontrent ce problème, effectuer un diagnostic interne du réseau dans l’ordre suivant :

1. Le terminal peut-il se connecter au Wi-Fi ou au réseau cellulaire?
2. Le réseau local est-il en panne?
3. Le site peut-il accéder à Internet en sortie?
4. Y a-t-il une panne entre le site et Moneris?
5. Contacter le support Moneris pour vérifier s’il y a un incident.

Il existe un cas limite où ‘5906’ ou ‘5907’ est retourné, et le terminal fournit une autre réponse négative ou relance la transaction dans la file d’attente.

Tests des erreurs de communication

‘5906’

1. Effectuer une transaction financière (ex : Purchase (achat) / Independent Refund (remboursement indépendant)).
2. Sur l’écran d’entrée de carte, désactiver les connexions Wi-Fi et 4G.
3. Puis tapoter / insérer la carte et attendre que la transaction soit refusée au terminal.
4. Moneris Cloud retournera le code d’erreur 5906.
5. Réactiver la connexion Wi-Fi ou cellulaire.
6. Renvoyer la requête d’origine à Moneris pour obtenir la réponse finale.

‘5907’

1. Effectuer une transaction financière (ex : Purchase (achat) / Independent Refund (remboursement indépendant)).
2. Sur l’écran d’entrée de carte, désactiver le Wi-Fi et la connexion cellulaire pendant 2 secondes, puis réactiver le Wi-Fi.
3. Puis tapoter / insérer la carte et attendre que la transaction soit approuvée ou refusée.
4. Moneris Cloud retournera le code d’erreur 5907.
5. Renvoyer la requête d’origine à Moneris pour obtenir la réponse finale.