Identifying yourself when exchanging with the payment gateway

SOAP HEADER of the query is used for identification.

To identify the merchant website during data exchange with the payment gateway, the following elements are required:

  • shop ID (shopId),
  • The key,

    To retrieve these two values, follow the steps below:

  1. Sign in to the Lyra Collect Back Office:
  2. Enter your login.
  3. Enter your password.
  4. Click Login.
    In case of an entry error of the login and/or password, the error message "Invalid username or password" will appear.
    You can correct your entry or click on the link Forgotten password or locked account.
  5. Click Other actions.
    The following window appears:
  6. Click on Expert Back Office to access your Expert Back Office
  7. Go to Settings > Shop.
  8. Select the Keys tab.
    Figure 1. Viewing the shop identifiers and the key

    Note: we recommend to store this data in a configuration file.

  • an authentication token that should be transmitted in the SOAP HEADER.

The computation of the authentication token is based on the HMAC_SHA256 hash algorithm.

It is built with the help of the SHA-256 hash function and used as HMAC code (Hash-based Message Authentication Code).

The length of the final hash is 256 bits.

Note: the HMAC_SHA256 function in PHP is available only starting from version 5.1.2.