Comprendre le mode de calcul de la signature

Une clé (ou "certificat") est nécessaire pour dialoguer avec la plateforme de paiement.

Deux certificats sont disponibles dans votre Back Office depuis le menu Paramétrage > Boutique > onglet Certificats :
  • une pour le mode de test,
  • une pour le mode de production.

La clé permet de calculer la signature numérique.

Pour calculer la signature :
  • Les champs de type numérique ne doivent pas avoir de 0 à gauche du digit le plus significatif
  • Les champs de type bool prennent les valeurs 1 (true) ou 0 (false)
  • Les champs de type string non renseignés seront vides

Afin de simplifier le calcul de signature, les champs de type dateTime et le champ template ne sont pas pris en compte.

  1. Respectez l'ordre des champs :
    • Création d'un ordre de paiement :
    shopId, reference, ctxMode, amount, currency, locale, message, recipients, subject, validationMode, validity, sendMail, expandedData
    • Modification d'un ordre de paiement :
    shopId, offerId, reference, ctxMode, amount, currency, locale, message, recipients, subject, validationMode, validity, sendMail, expandedData
  2. Assurez-vous que tous les champs soient encodés en UTF-8.
  3. Concaténez les valeurs de ces champs en les séparant avec le caractère "+".
  4. Concaténez le résultat avec la clé de test ou de production en les séparant avec le caractère "+".
  5. Appliquez l'algorithme de hachage SHA-1 sur la chaîne.

En mode TEST, en cas de mauvais calcul de signature, errorCode sera valorisé à "2" dans la réponse et la chaine de caractères utilisée pour la signature côté serveur est retournée dans le champ errorDetail.