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ément | Type | Description | Taille | Obligatoire |
|---|---|---|---|---|
| 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ément | Type | Description | Taille | Obligatoire |
|---|---|---|---|---|
| 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.

