Commande authenticate (authentifier)

Vue d'ensemble

Lorsque le RMS établit un socket sortant, il envoie un message d’authentification (handshake) contenant le merchantId (identifiant du commerçant) et le apiToken (jeton API). Moneris fournit un identifiant de commerçant et un jeton API pour chaque solution commerçant. Un handshake est requis chaque fois qu’un socket est établi. Le handshake associe le terminal au RMS et l’authentifie. Le traitement des transactions peut commencer après un handshake réussi.

REMARQUE: Chaque connexion POS de restaurant au Moneris RMS doit utiliser un merchantId unique.

Structure de la requête

ÉLÉMENT	TYPE	DESCRIPTION	TAILLE	OBLIGATOIRE
action	String	Type de transaction – « authenticate »	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": "authenticate",
   "cloudApiVersion": "1.0",
   "merchantId": "0030112345678",
   "requesId": "I9000001-1555449670-037",
   "responseTimestamp": "yyyy-mm-dd hh:mm:ss",
   "status": "200",
   "statusDesc": "OK"
}

Structure de la réponse

ÉLÉMENT	TYPE	DESCRIPTION	TAILLE	OBLIGATOIRE
action	String	Type de transaction – « authenticate »	V24	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
responseTimestamp	String	Date et heure de la requête	F19	Obligatoire
status	String	Code d’état	F3	Conditionnel
statusDesc	String	Description du code d’état	V50	Conditionnel


{
   "action": "authenticate",
   "cloudApiVersion": "1.0",
   "merchantId": "0030112345678",
   "requesId": "I9000001-1555449670-037",
   "responseTimestamp": "yyyy-mm-dd hh:mm:ss",
   "status": "200",
   "statusDesc": "OK"
}