Step 2: Authenticate him/herself

Objective

• Secure data exchanges.

I. Retrieving the keys

1. Sign in to the Merchant Back Office

2. Click on Other Actions , from the Merchant Back Office. The following window will appear:

• In the Settings > Shop menu, select your shop and go to the REST API keys tab.

Table of REST API keys :

For each use, there is a key for the TEST mode and a key for the PRODUCTION mode.

This action is performed by a user who is authorized to manage keys and signing algorithms. Additionally, access to the REST API Keys tab requires specific functionality to be enabled. Please contact your customer service if you do not see this tab.

More info: REST API keys.

II. Authentication phase

1. Create a string with the user and the password separated by a colon (:)

• the username is the shop identifier: N° 1: user of the REST API key table
• thePassword, for example, for the test storetestpassword_DEMOPRIVATEKEY23G4475zXZQ2UA5x7M : 2: REST API key table password

2. Encode the obtained chain in base64

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

   Authorization: Basic Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN

4. For example, for PHP , the Authorization header will be calculated as follows:

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

Here is an example of a request. You can use the TEST SDK provided in the Playground to test your integration.

The complete HTTP request will resemble the image below. You can use the TEST SDK available via the Playground.

{
    "value": "my testing value"
}

III. Code samples

Code samples, in different languages , are available in GitHub.

IV. Simplified example in PHP

In the sample folder, the file of this step is config.php. It allows you to define the authentication keys.

For more details, Example file: config.php.