Générer un uuid - rétrocompatibilité

Un uuid (Universally Unique IDentifier) est un identifiant unique qui permet, dans cette version des Web Services, d'identifier de façon absolument sûre une transaction.

Cependant, l'uuid n'était pas généré dans les versions précédentes.

Pour identifier et interroger une transaction, les attributs transactionId, sequenceNumber et creationDate étaient utilisés.

Ils permettaient de cibler une transaction spécifique à partir de :

  • son identifiant unique sur une journée,
  • la date et l'heure de la requête à laquelle la transaction était créée,
  • le numéro de séquence.

Dans cette version, seul l'attribut uuid (référence unique de la transaction) est nécesssaire.

Il est utilisé pour remplacer les anciens attributs et simplifier les requêtes.

Il est généré par la plateforme de paiement suite à la création d'une transaction de paiement. Cet identifiant unique offre une garantie d'unicité.

La valeur de cet attribut est retournée dans l'objet paymentResponse de l'opération createPayment.

Ainsi, pour toute requête impliquant une transaction spécifique, l'attribut uuid sera demandé au sein de l'objet queryRequest.

Cependant, pour des raisons de retrocompatibilité, cette version des Web Services permet de récupérer l'uuid d'une transaction (référence unique de la transaction) à partir de son ancienne identification.

Pour cela, l'operation getPaymentUuid est mise à disposition.