Commande echo (écho)
Vue d'ensemble
Une fois que le système de restaurant a effectué avec succès un handshake d’authentification, il doit envoyer un message de requête d’écho au RMS toutes les 30 secondes pour maintenir la connexion active. Si le RMS ne reçoit pas la commande echo, la connexion sera interrompue.
Le RMS de Moneris n’autorise qu’une seule connexion par identifiant de commerçant. Les tentatives de connexion supplémentaires d’un serveur utilisant un identifiant de commerçant actif seront rejetées.
Structure de la requête
| ÉLÉMENT | TYPE | DESCRIPTION | TAILLE | OBLIGATOIRE |
|---|---|---|---|---|
| action | String | Type de transaction – « echo » | V24 | Obligatoire |
| apiToken | String | Jeton API du demandeur | V50 | Obligatoire |
| cloudApiVersion | String | Numéro de version de l’API | V20 | Obligatoire |
| merchantId | String | Identifiant du commerçant | V13 | Obligatoire |
| requestId | String | Identifiant de la requête | V50 | Obligatoire |
| requestTimestamp | String | Date et heure de la requête | F19 | Obligatoire |
{
"action": "echo",
"apiToken": "P14i5WS4P0uhgbrnN7BZ",
"cloudApiVersion": "1.0",
"merchantId": "0030112345678",
"requestId": "I9000001-1555449670-037",
"requestTimestamp": "yyyy-mm-dd hh:mm:ss"
}
Structure de la réponse
| ÉLÉMENT | TYPE | DESCRIPTION | TAILLE | OBLIGATOIRE |
|---|---|---|---|---|
| action | String (chaîne) | Type de transaction – « authenticate » | V24 | Obligatoire |
| cloudApiVersion | String (chaîne) | Numéro de version de l’API | V20 | Obligatoire |
| merchantId | String (chaîne) | ID du commerçant demandeur | V13 | Obligatoire |
| requestId | String (chaîne) | Identifiant de la demande | V50 | Obligatoire |
| responseTimestamp | String (chaîne) | Date et heure de la demande | F19 | Obligatoire |
| status | String (chaîne) | Code d’état | F3 | Conditionnel |
| statusDesc | String (chaîne) | Description du code d’état | V50 | Conditionnel |
{
"action": "echo",
"cloudApiVersion": "1.0",
"merchantId": "0030112345678",
"requestId": "I9000001-1555449670-037",
"responseTimestamp": "yyyy-mm-dd hh:mm:ss",
"status": "200",
"statusDesc": "OK"
}

