Authentication phase

Each call requires an authentication based on the HTTP Basic Authentication method.

This method uses the Authorization HTTP header consisting of the word Basic followed by a string encoded in base64 containing a username and a password separated by a colon (:).

• The username is the shop identifier, for example: 28478261
• The password is defined in the Merchant Back Office: for example testpassword_HDBz5YpANEajG4DwYSmkQDNM9lzGiuvrhY9f6G9HEm5do.

The username and password are available in the Merchant Back Office, Settings > Shop menu, REST API keys tab.

How to build the “Authorization” HTTP header

1. Create a string presented asusername:password

   42229744:testpassword_IvhGC31Fb7m48mNmgdmRSGa5RkGy5nc0FXcvR1uKog8Ms

2. Encode the obtained chain in base64

   Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN

3. Add the “Authorization” header to your request containing the word “Basic” followed by the string encoded in base64:

   Authorization: Basic Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN

In PHP, the Authorization header will be calculated as follows:

$header = "Authorization: Basic " . base64_encode($username . ':' . $password);

The full HTTP request will look like this:

{
    "value": "my testing value"
}

Useful links

For more details on implementation in different languages, see the following Gitub gists.