Idempotence

Une méthode de requête est considérée comme « idempotente » si l’effet prévu sur le serveur de plusieurs requêtes identiques avec cette méthode est le même que l’effet d’une seule requête.

L’API Cloud de Moneris prend en charge l’idempotence afin de relancer en toute sécurité des requêtes sans exécuter deux fois la même opération sur l’hôte d’autorisation. Cela est utile lorsque votre appel API est interrompu et que vous ne recevez pas de message de réponse.

Par exemple, si une requête pour une transaction « achat » ne reçoit pas de réponse en raison d’une erreur de connexion réseau, vous pouvez relancer la requête avec la même clé d’idempotence pour garantir que le titulaire de la carte ne sera pas facturé deux fois.

  • préautorisation (Pre-Authorization

  • finalisation de préautorisation (Pre-Authorization Completion)

  • activation/chargement (Activate/Load)

  • désactivation (Deactivate)

  • obtention des données de piste (Get Track Data)

  • obtention du hachage (Get Hash)

  • vérification de carte (Card Verification

L’idempotence est prise en charge uniquement pour les transactions suivantes:

  • synchronisation (Sync)

  • lecture (Scan)

  • achat (Purchase)

  • remboursement avec carte enregistrée (Card-on-file Refund)

  • remboursement carte présente (Card Present Refund)

  • annulation (Void)

  • annulation du dernier achat (Void Last)

  • consultation de solde (Balance Inquiry)

Scénarios de codes de réponse idempotents

Dans tous les cas suivants, on suppose que la nouvelle requête entrante possède une clé d’idempotence identique à celle de l’une des cent dernières commandes traitées.