Guides
Log In
Guides
  1. Intégration de paiement Moneris Go
  2. Définition de l'API
  3. Manage Terminal

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
apiVersion String (chaîne) Numéro de version de l'API V20 Obligatoire
istConfigCode String (chaîne) Code de configuration d'intégration fourni par Moneris V50 Obligatoire
dataId String (chaîne) Identifiant unique défini par le commerçant pour l'objet de données V50 Obligatoire
dataTimestamp String (chaîne) Date et heure de la requête (AAAA-MM-JJ HH:MM:SS) F19 Obligatoire
data Object (objet) Objet contenant toutes les requêtes de transaction - -
request Array (tableau) Contient les données applicables à la requête de transaction - -
idempotencyKey String (chaîne) Identifiant unique de transaction pour éviter une requête en double V50 Obligatoire
action String (chaîne) "getDeviceInfo" V50 Obligatoire
terminalId String (chaîne) ID du terminal de destination F8 Facultatif

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
apiVersion String (chaîne) Numéro de version de l'API V20 Obligatoire
statusCode String (chaîne) Code d'état pour la requête de transaction globale V4 Obligatoire
status String (chaîne) Description du code d'état V50 Obligatoire
dataId String (chaîne) Identifiant unique défini par le commerçant pour l'objet de données V50 Obligatoire
dataTimestamp String (chaîne) Date et heure de la requête (AAAA-MM-JJ HH:MM:SS) F19 Obligatoire
data Object (objet) Objet contenant toutes les requêtes de transaction - -
response Array (tableau) Contient les données applicables à la requête de transaction - -
idempotencyKey String (chaîne) Identifiant unique de transaction pour éviter une requête en double V50 Obligatoire
action String (chaîne) "getDeviceInfo" V50 Obligatoire
statusCode String (chaîne) Code d'état pour la requête individuelle V4 Obligatoire
status String (chaîne) Description du code d'état individuel V50 Obligatoire
completed String (chaîne) "true" ou "false" V5 Obligatoire
appVersions Array (tableau) Contient les données applicables à la requête de transaction - -
name String (chaîne) Nom de l'application V100 Facultatif
version String (chaîne) Version de l'application V100 Facultatif
build String (chaîne) Build de l'application V100 Facultatif
buildTime String (chaîne) Heure de build de l'application (AAAA-MM-JJ HH:MM:SS) F19 Facultatif
mac String (chaîne) Adresse de contrôle d'accès au support réseau actif (mac) V50 Facultatif
hardwareSn String (chaîne) Numéro de série du fabricant V50 Facultatif
terminalId String (chaîne) ID du terminal de destination F8 Facultatif
printerSupported String (chaîne) Retourne "true" si l'appareil dispose d'une imprimante intégrée F5 Facultatif
scannerSupported String (chaîne) Retourne "true" si l'appareil dispose d'un scanner optique intégré F19 Facultatif

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.

Mise à jour il y a 3 jours

Cette page vous a-t-elle aidé ?