Obtenir le hachage (Appareil IM30 uniquement)

Vue d'ensemble

La transaction Get Hash (obtenir le hachage) est utilisée pour récupérer la valeur de hachage d’une carte. Au lieu de stocker les détails bruts d’une carte, le commerçant utilise le hachage comme jeton pour référencer la carte de manière sécurisée. Le hachage garantit que les données de carte ne sont pas exposées lors de l’autorisation, réduisant ainsi le risque d’interception.

📘

Remarque

• Le PAN masqué comportera toujours les 6 premiers et les 4 derniers chiffres.
• hashValueSecondary (valeur de hachage secondaire) sera présent dans la réponse uniquement pendant la période de grâce et lorsque le champ newHash (nouveau hachage) (facultatif) n’est pas présent ou défini à false (valeur booléenne fausse).
• Other (autre) désigne tout type de carte non reconnu par le terminal (ex. : carte-cadeau ou plan de carte pris en charge par l’application mais non activé par la synchronisation avec l’hôte Moneris).
• Ce champ est toujours renvoyé lorsque le champ facultatif hashValueSecondary est présent dans la réponse.

Structure de la requête

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

Structure de la réponse

{
   "apiVersion":"3.0",
   "statusCode":"example_statusCode",
   "status":"example_status",
   "dataId":"example_dataId",
   "dataTimestamp":"1969-12-31 23:59:59",
   "data":{
      "response":[
         {
            "transactionId":"example_transactionId",
            "statusCode":"example_statusCode",
            "status":"example_status",
            "idempotencyKey":"example_idempotencyKey",
            "completed":"true",
            "tenderType":"example_tenderType",
            "cardType":"example_cardType",
            "authCode":"example_authCode",
            "maskedPan":"example_maskedPan",
            "hashValue":"example_hashValue",
            "entryMode":"example_entryMode",
            "action":"getHash",
            "terminalId":"example_terminalId"
         }
      ]
   }
}

Erreurs

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