Guides
Log In
Guides

Obtenir les informations de l'appareil

Vue d'ensemble

La commande d’obtention des informations sur l’appareil permet à un système PDV de récupérer des informations détaillées sur un terminal Moneris Go, notamment les versions logicielles, les capacités matérielles et les identifiants uniques. Cette commande est essentielle pour le diagnostic, la gestion des inventaires et la garantie de la compatibilité avec les applications intégrées.

En plus des métadonnées de base de l’appareil, la commande retourne des informations sur les applications de traitement de paiements installées et les paramètres de configuration du terminal — tels que la prise en charge des pourboires, des remises en argent, des frais supplémentaires et d’autres réglages. Ces informations sont précieuses pour comprendre les capacités opérationnelles du terminal et garantir leur alignement avec les exigences de configuration du marchand.


📘

Remarque

Il est fortement recommandé d’émettre cette commande lors du démarrage de le PDV et de consigner les détails retournés. La capture de ces informations en amont permet de simplifier le dépannage et fournit un point de référence fiable pour toute investigation en cas de problème durant l’exploitation.


Structure de la requête

ÉlémentTypeDescriptionTailleObligatoire
apiVersionString (chaîne)Numéro de version de l'APIV20Obligatoire
istConfigCodeString (chaîne)Code de configuration d'intégration fourni par MonerisV50Obligatoire
dataIdString (chaîne)Identifiant unique défini par le commerçant pour l'objet de donnéesV50Obligatoire
dataTimestampString (chaîne)Date et heure de la requête (AAAA-MM-JJ HH:MM:SS)F19Obligatoire
dataObject (objet)Objet contenant toutes les requêtes de transaction
requestArray (tableau)Contient les données applicables à la requête de transaction
idempotencyKeyString (chaîne)Identifiant unique de transaction pour éviter une requête en doubleV50Obligatoire
actionString (chaîne)"getDeviceInfo"V50Obligatoire
terminalIdString (chaîne)ID du terminal de destinationF8Facultatif

Exemple de requête

{
  "apiVersion": "3.0",
  "istConfigCode": "example_istConfigCode",
  "dataId": "example_dataId",
  "dataTimestamp": "1969-12-31 23:59:59",
  "data": {
    "request": [
      {
        "idempotencyKey": "example_idempotencyKey",
        "action": "getDeviceInfo"
      }
    ]
  }
}

Structure de la réponse

ÉlémentTypeDescriptionTailleObligatoire
apiVersionString (chaîne)Numéro de version de l'APIV20Obligatoire
statusCodeString (chaîne)Code d'état pour la requête de transaction globaleV4Obligatoire
statusString (chaîne)Description du code d'étatV50Obligatoire
dataIdString (chaîne)Identifiant unique défini par le commerçant pour l'objet de donnéesV50Obligatoire
dataTimestampString (chaîne)Date et heure de la requête (AAAA-MM-JJ HH:MM:SS)F19Obligatoire
dataObject (objet)Objet contenant toutes les requêtes de transaction
responseArray (tableau)Contient les données applicables à la requête de transaction
idempotencyKeyString (chaîne)Identifiant unique de transaction pour éviter une requête en doubleV50Obligatoire
actionString (chaîne)"getDeviceInfo"V50Obligatoire
statusCodeString (chaîne)Code d'état pour la requête individuelleV4Obligatoire
statusString (chaîne)Description du code d'état individuelV50Obligatoire
completedString (chaîne)"true" ou "false"V5Obligatoire
appVersionsArray (tableau)Contient les données applicables à la requête de transaction
nameString (chaîne)Nom de l'applicationV100Facultatif
versionString (chaîne)Version de l'applicationV100Facultatif
buildString (chaîne)Build de l'applicationV100Facultatif
buildTimeString (chaîne)Heure de build de l'application (AAAA-MM-JJ HH:MM:SS)F19Facultatif
macString (chaîne)Adresse de contrôle d'accès au support réseau actif (mac)V50Facultatif
hardwareSnString (chaîne)Numéro de série du fabricantV50Facultatif
terminalIdString (chaîne)ID du terminal de destinationF8Facultatif
printerSupportedString (chaîne)Retourne "true" si l'appareil dispose d'une imprimante intégréeF5Facultatif
scannerSupportedString (chaîne)Retourne "true" si l'appareil dispose d'un scanner optique intégréF19Facultatif

Exemple de réponse

{
  "apiVersion": "3.0",
  "statusCode": "example_statusCode",
  "status": "example_status",
  "dataId": "example_dataId",
  "dataTimestamp": "1969-12-31 23:59:59",
  "data": {
    "response": [
      {
        "idempotencyKey": "example_idempotencyKey",
        "action": "getDeviceInfo",
        "statusCode": "example_statusCode",
        "status": "example_status",
        "completed": "true",
        "appVersions": [
          {
            "name": "example_name",
            "version": "example_version",
            "build": "example_build",
            "buildTime": "1969-12-31 23:59:59"
          },
          {
            "name": "example_name",
            "version": "example_version",
            "build": "example_build",
            "buildTime": "1969-12-31 23:59:59"
          }
        ]
      }
    ]
  }
}

Erreurs

Si votre réponse contient des erreurs, consultez la page Erreurs pour une description détaillée de chacune.