Understanding the computation method of the signature

A key (or "certificate") is required to communicate with the payment gateway.

Two certificates are available in your Back Office from the menu Settings > Shop > Certificates tab :
  • one for TEST mode,
  • one for PRODUCTION mode.

The key value is used to compute the alphanumeric signature.

To compute the signature:
  • The Numeric type fields can't have a 0 to the left of the most significant digit.
  • The bool type fields take the values 1 (true) or 0 (false)
  • The unfilled string type fields will be empty

To simplify the signature calculation, all dateTime fields and the template field are ignored.

  1. Respect the order of the fields :
    • Creation of a payment order :
    shopId, reference, ctxMode, amount, currency, locale,message, recipients, subject, validationMode, validity, sendMail, expandedData
    • Modification of a payment order :
    shopId, offerId, reference, ctxMode, amount, currency, locale,message, recipients, subject, validationMode, validity, sendMail, expandedData
  2. Make sure that all the fields are encoded in UTF-8.
  3. Concatenate the values of these fields separating them with the "+" character.
  4. Concatenate the result with the test or production key separating them with a "+".
  5. Apply the SHA-1 algorithm to obtain the signature value.

In TEST mode, n case of bad signature computation, the errorCode returned is "2" and the string used for signature on the server is then returned in the errorDetail field.